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USER NOTES 

CodeWriter (FileWriter) Atari Version 

PLEASE NOTE: There are screen illustrations in your manual which cannot be duplicated on a 40 column screen (such as 
your Atari). Simply follow the screen examples the best you can by abbreviating some words and/or mak¬ 
ing the dotted lines shorter. ( 

IMPOR FANT: FOLLOW THE SC KEEN MESSACSES. Fhe Atari disk you received is the latest version of the program. 

If an instruction in the manual seems to contradict the on-screen instruction, FOLLOW THE SCREEN. 

1. Don't touch the Atari 'break' key while using the program. 

2. It's best to limit your programs to ONE PER DISK. 

Where a large size asterisk (*) appears in tlie margin of your manual, you MAY need to refer to this 
USER NOl'ES CARD. The following notes are referenced by the PACjE NUMBER on which the 
asterisk appears (not all asterisks in the manual w'ill be referenced here). 

page 4 You'll need: An Atari computer with 48k ram memory, an Atari BASIC cartridge, at least one disk drive, and 

one or two blank disks. An Atari compatible printer is optional. 

page 4 LOADINCj PROC IiDURI.:: Your Atari disk is AUIO LOAD capable. Do the following IN ORDER. 1. turn 

OEF your computer. 2. turn ON your disk drive and wait for the red activity light to go out (about 3 seconds). 

3. insert the Dynatcch disk. 4. insert the Atari BASK cartridge and then turn ON the computer. You should 
.soon see “Dynatech Microsoftware Presents..." etc. 

page 4 (NO ASTERISK) I'he “set dis[4a\ colors" option is NO'F in the Atari version. 

page 4 (NO ASTERISK) Follow the SC'REEN INSTRUC FIONS to format a disk. 

page 4 (NO ASTERISK) I he menu called ‘Create Data Entry System' in your manual is titled 'Atari CodeWriter 

Main Menu' in the Atari version. 


page 6 The option to ,send your screen design to the printer is not present in the Atari version. You can, however, 

print a completed data entry screen once you're using your application. More about this later. 

page 7 Your Atari system does NOT require ‘up' arrows to denote labels. Simply use REVERSE VIDEO to designate 

a label. Pre.ss the Atari symbol key to go into reverse video. Press the symbol key again to leave reverse mode^^ 
(On the 'XL' series, the Atari symbol key is replaced by a dark/whitc oblong symbol in the function key row.) 

page 7 Your Atari screen is limited to 50 fields. 


page 8 


page 13 
page 18 

page 19 
page 19 

page 20 
page 21 
page 22 


page 24 
page 25 


You may use the ATARI GRAPHIC'S keys to make labels. Press the correct symbol key to enter the 
REVERSE mode. Press the CONTROL key and, while holding it dowm, your keyboard w'ill print graphics 
characters to the screen. See the back page of your Atari ILASIC' manual for the correct layout of the graphics 
keys. 

You are ALLOWED to use the comma, colon, or semicolon w'ith your Atari. 

In the CHANGE SC'REEN mode, use the Atari cursor keys to skip from field to field. While holding down 
the CONTROL key, press the right cursor key to skip to the next field and the left cursor key to skip to the 
previous field. Once the cursor is t)n the field you wish, press the RETURN key as usual. 

Use the ESC key to exit the CFlANCiE mode. 

(NO ASTERISK) Your Atari system will NOT ALLC9W lower case to be u,sed to name a file (the keyboard 
will auto-switch to caps-only temporarily). 


Again, use ESC to exit CHANGE mode. 

(NO ASTERISK) Contrary to the manual, your Atari system does allow two disk drives to be used. 

(NO ASTERISK) The Atari system will designate ALL CREATED FIELDS with an 'F' (as in FI, F2, F6, 
etc.) rather than calling a keyboard entered field 'kel' and a program calculated field ‘pel’, etc. Therefore, your 
‘list’ of fields will look somewhat different from the list pictured in the manual. U,se ‘L’ to view this list. Use 
the ESC key to return from a list. 


(NO ASTERISK) Enter 'F3’ rather than 'pc3’ to follow the example. 

(NO ASTERISK) You may use ANY NUMERIC FUNCTION legal in Atari BASIC rather than the four 
listed in the CodeWriter Concepts section. Beginning designers should limit themselves to these four for a 
while at least. 



page 26 
page 30 

page 3! 

page 34 


page 35 

pages 36, 37 
page 38 

page 42 
page 43 

NOTE: 

NOTE 2: 


(NO ASTERISK) Self referencing fields are noi used in the Atari version. 

(NO ASTERISK) Dollar fields are RIGH I JUS IIFIED on the Atari system. Simply line up the dollar signs 
on the right rather than the dots to the left. 

(NO ASTERISK) 1 here is not an AU lOMAI IC DEE AULT message on the Atari system. If you need an 
on-screen error mes.sage, youll be prompted to write one. 

Follow the on-scrceri prompts to run your new program. Once your computer is off, do the following to run 
your program the next time: I. load your Atari DOS master disk. 2. once the 'readv’ prompt and cursor ap¬ 
pear, run the program by typing in (assuming your screen file is named SAMPLE); 

RUN ••D:SAMPI,F..PRG” 

do get a disk directory on the Atari, load the DOS master and type ‘DOS' to see an options list. Select option 


The references to the ‘FT key should be ESC on Atari. 

^ via the ‘look up' option, you may PRINT the screen by using the 

SELEC r key on the Atari. The Atari 825 printer will work as will any properly interfaced printer which sup¬ 
ports the LPRIN I command. * 


(NO ASTERISK) In the ‘length’ explanations, two new options should be added. They are- ‘length> = ’ mean¬ 
ing ‘greater than or equal to' and ‘length <=’ meaning ‘less than or equal to’. 

(NO ASTERISK) In using the ‘letter test’ be sure to use SINGLE QUOTES to describe the letters or words to 
be tested. Eor example, contains ‘abc' or — 1Vog’. 


Your Atari system will allow Yeject if testing on DATES as well 
with any other lield. No quote marks around a date are needed, 
dates AFTER July 4lh, 1984 the form is: reject if: >7/4/84 

SAME FORMAT (American or European) as the date entered. 


Use the >,<, =,<>,<=,>=: symbols as 
As an example, il you wished to reject all 
Naturally, the date tested needs to be in the 


loTa WHOrF'NU\7?FR ^ ’mieger’ and ‘not integer’, for testing whether or 

no a ^HOLE NUMBER is being entered. The second new test is lor value. This is used for numeric 

testing ol helds which arc not iruh numbers (such as /ip cixlesi. 'I'ou wouldn't calculate on a zip code but 
testing lor a number range can he useful. ^ * 



USER NOTES 

CodeWriter (FileWriter) Atari Version 

PLKASI'', NO'ri-'.; The following pages are designed lo be used while following Ihe manual. In order to gain a full 

understanding of the C odeWriter Report System, follow along in the manual and note the changes, 

1 he changes will be shown with the corresponding page and screen number where applicable. 

The Atari Report Creation System is on two disks, labelled Part A and Part B. You will be prompted to 
insert either one or the other when a disk swap is required. 


page 45 Disregard what the manual says here. CodeWriter for the Atari automatically transfers the programs needed to 
your disk. Simply follow the .screen instructions. They will tell you if and when to swap disks. 

page 46 Under the number two on this page, you now have the ability to .scroll hori/ontally and vertically over your 
report lormat using the special cursor commands. The.se commands are explained on the table below. 

IMPDR I ANT: C URSOR MOVKiMUNTS 

KIY FUNCTION 


page 47 

page 47 
page 47 
page 47 


I^agc 47 
Page 47 

Page 49 
page 49 

page 50 
page 50 
page 50 


page 50 
page 51 

page 51 

page 52 


page 52 
page 52 
page 52 

page 53 


I — ] Up one space 

I = 1 Down one space 

1 f I l.eft one space 

I 1 Right one space 

I 4 I Up ten spaces 

1 t 1 Down ten spaces 

I I Left ten spaces 

[ 1 Right ten spaces 

I 1 Page up 

I I l^ige down 

1 \ I l^ige left 

1 A ) Page right 

Screen R3 is lor the input ol the rej')ort number you will use to identify your program. The number must be 
between 1 and 99 inclusive. You will be asked to verify this if there is another report with the same number. 

Screen R6. Your title may use up to 25 characters. 

You will be asked to verify your design credit and title upon entry. You will not see an example title page here. 

Screen R7 for the Atari asks you if would like to define more progrrn calculated fields. This will determine 
what you will do next. If you say hio’ at this point, you will skip to screen RIO. 

All fields are numbered using 4" instead of 'Kl:\ and Xl'l '. 

Screen R9A. All new program calculated fields are assumed to be numeric. For dollar formatting, choose to 
have numeric formatting with two decimal places. 

Screen RIO. You will see a series of screens to assist you in creating your report format. 

Screen R1 I. Remember, you access to the entire report format by using the imporved cursor movements. A 
is used for help instead of TT. 

Screen R12. After exiting the screen format you will be asked to verify your format. 

If you would like to view' your entire screen, just use the cursor commands. 

Screen R15. While entering headings, simply type across the entire report. The screen will automatically scroll 
along with you. You need not hit RETUF^N until you have completed an entire line. You may use the cursor 
left (Ctrl -h) and cursor right (ctrl *), the insert, delete, and backspace keys. The ESC key gives you the option 
to list fields or view the help screen. 

Screen f^I6 occurs after the new program has been loaded. 

Screen RI6A. CodeWriter for the Atari does not support the logical operand ‘NOT’. Remember that ‘F’ is 
used instead of T^C’, ‘KE’, and ‘GT’. 


If your data entry program does not have any numeric or dollar fields, you will not be allowed to have sum¬ 
maries. You will not be asked if you want records, summaries, or both and records only will be assumed. 

Screen R17 will occur after you have specified your summary format. You are asked if you want an overall 
summary which includes a summary of all your summaries and may include grand totals from your data entry 
program. 


Screen R18. To move to the next option while formatting your summary, press RETURN. 
Screen R19 occurs on Screen R18. You must verify your summary format here. 


Screen R20 does not exist on the Atari version. Your report will be a TWO digit number that you defined 
earlier. If you choose the number 1 for your report, it would be identified with an ‘R’ followed by ‘OF. 

It is not necessary for you to run the sort program. All you must do is run your report program. The sort pro¬ 
gram will automatically be run from the generated program. There is a screen with instructions shown im¬ 
mediately following the creation of your program. Just follow the instructions here. 
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The CODEWRITER Program Series, developed over the last two 
years, owes its existence to the following—who were never afraid 
to walk in the dark: 
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V/arren Shore 
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This manual was written to be as unique and useful as the 
CX)DEWRrrER SYSTEM itself. That is a tall order. Please believe us 
when we say that everyone at Dynatech Mlcrosoflware worldwide 
has worked to make CODEWRITER among the most valuable 
programs you can own. 

There has been a great deal written about “Program Generation”, 
both good and bad, pro and con. Let’s begin with a simple 
statement about why THE CODEWRITER SYSTEM was developed 
over the last two years (since 1980): 

There is only one reason for computers. To allow people to control 
the mformation around them. But computers deal in code while 
people deal in ideas. As personal computers become available to 
more and more people, “programming” in arcane and unforgiving 
code gets in the way more and more. The same people who 
understand the information a computer holds must be able to 
control that information directly. In this way, ideas can dominate 
rather than hardware. 

THE CODEWRITER SYSTEM allows the non-programmer with an 
idea for ordering information to see that idea take shape on a 
personal computer. If the idea has elements which can be put on a 
screen or written on paper, CODEWRITER will structure those 
elements so a computer can accept them, retrieve them, re-order 
them and create a pattern for understanding. 

Of course, none of this is magic. CODEWRITER only substitutes 
“programming” with “Program Design”. But the difference is 
critical. The programmer has two problems at all times; One is the 
idea at hand and the second is the job of reducing that idea to a 
“language” vastly more primitive than human thought. 

While Program Design is a great deal easier, it is hardly trivial. 
The simplicity of CODEWRITER Program Design comes from dealing 
with a problem directly in the designer’s own language. 

f HAT’S ENOUGH TKEOEY 

CODEWRITER will create all the computer code needed to get a 
program up and running on your computer. Once you’re done 
“designing”, you’ll see the code written out on your computer 
screen as it is automatically recorded onto your disk. 

For the most part, THE CODEWRITER SYSTEM is “self 
documented”—that is most of what you need to know to design a 
program is written on the screen for you and will ro-appear each 
time you use the system. 


But use tnis manual anyway! There is very little more ', 
inside. We have designed an example program—complete 


eTOh 


every single k^stroke needed to create that program using only 
human language. 


Naturally, our example program is unlikely to do exactly the 
things you bought CODEV/RITER to do. For now, that’s not 
important. The example will show a great number (but not all) of 
the features of the CODEWRITER system. 

More importantly, the example program will show how these 
features work together to solve a complex problem one step at a 
time. 


Put the manual in front of your computer where you can read it 
comfortably. Turn your computer on and begin a process you’ll not 
soon forget. 

You’re about to increase your dominion over the single most 
stimulating invention of the twentieth century. Have fun. We envy 
you and wish you well. 

A WOKD ABOUT SOFTWARE PROTECTION 

At Dynatech Microsoftware we have some very definite ideas 
about protecting software. We feel that both the software 
developer and the software customer have rights which must be 
protected. The developer must be protected from “unauthorized 
use” of his work. After all, if the market place does not reward 
the developer for his work the work will not be produced, not be 
supported, and not be improved. 

But workable software protection cannot exclude the customer’s 
rights. The paying customer makes ail new software possible. 

Thus, the customer should be able to use the software freely and 
with confidence. A ’back-up’ copy of your Commodore 64 
CODEWRITER disk is available at a small cost (See the coupon 
included with your system). Also, a free one year guaranty is 
part of your system cost. If your CODEWRITER disk fails to 
operate for any reason during this period, we’ll replace it fi'ee. 

Once your purchase is registered, you’ll be notified of our toU-free 
help line for any problems you might have with your 
CODEWRITER system. 

In addition, whenever possible we’U add new features (or improve 
existing features) to the CODEWRITER system at no increase in 
retail price. We’ll be glad to UPGRADE your existing system free if 
you’ll simply send your diskB in. Watch our ads for these 
changes—or simply call to make sure your version is the latest. 
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Please ei^ay your CXIDEWRITEH system. We developed it to be the 
best. 
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Before you begin working with your Commodore CBM 64 
CODEWRITER system, make sure you have the following; 

A Commodore CBM 64 microcomputer 
A 1541 Commodore disk drive 

(In some cases a modified 1540 drive will do—see your dealer. A 
4040 dual disk drive will also work, though this edition of 
CODEWRITER 64 w]l use only drive 0.) 

A blank, formatted diskette. 

A Commodore compatible printer is optional. 

(SPECIAL NOTE: Some commodore compatible options like Skyles’ 
VicTree will interfere with CODEWRITER operations. Please remove 
them before you begin. If your system works erratically, check for 
these optional items before continuing.) 

Insert your CODEWTIITER disk (Disk 1 side up) in your disk drive. 
Press the SHIPT and Commodore symbol key ) lower left on 
keyboard) TOGETHER. This will activate the UPPER/Tower case 
m^e in which CODEWRITER operates. Next, type the fohowmg 
EXACM: 


load ”newmenu”,8 


After the program loads, your cursor (flashing square) will 
return along with the ’READY’ message. Type run 
After a short delay, the foUoTrtng screen should appear: 



If you have not already formatted a disk, do so now. 


Press T and then RETURN 


Pressing ’f will display a warning that formatting ERASES all 
information on a disk. REMOVE the CODEWRITER disk and insert 
your own disk. Type ’y’ and press RETURN. You’ll be asked to 
“name” your work disk using up to 16 characters and press 
RETURN. Formatting usually takes between 90 seconds and 2 
minutes. You’ll then be asked if you need another disk ’formatted’. 
Answer ’n’ and press RETURN. You should now see the 
CODEWRJTER System Main Menu again. 
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CODEWRITEH SYSTEM MAIN MENU 


Once back at the main menu with a formatted disk, we’re reacjy to 
create a data entry system. Press’d’ from the menu selection and 
then RETURN. 



Each CODEWRITER data entry program begins with a SCREEN 
LAYOUT. This is simply a form created on the screen which shows 
what kind of information (data) the program operator is to enter 
and how much space is allowed to do so. CODEWRITER makes this 
process as easy as possible. 


Press ’s’ and then RETURN 


Screenwriter Generator 
e- Edit or Create screen 
c- Change field positions 
s- Save screen layout to disk 
I- Load screen layout from 
disk 

X- Exit to System Creation 
Menu 


We’U look at all the options on this menu before we’re done, but 
for now the task is to CREATE A SCREEN so: 


Press ’e’ and then RETURN 


You should be looking at a screen full of instructions on how to 
accomplish writing a screen. This is for future reference in using 
CODEWRITER. For now the screen instructions might make the job 
look more complex than it really is. Let’s examine the instructions 
to sort things out: 
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CODEWRITER allows you to type anywhere on the screen to create 
the entry form you want. The screen instructions will show which 
keys on your computer allow you to move the cursor around the 
screen. 




FllJg— A FILE is a collection of information on a single^Pfect. 
thus a receivable file is a collection of information on who owes 
money to a particular company. A stamp collection file contains all 
the information about a certain stamp collection, etc. 


Your CODEWRITER 64 system allows you to make printed copies of 
your screen designs. You must have a Commodore (or compatible) 
printer connected to your system to do this. You’ll see a line at 
the bottom of your work screen which reads: 


Press f1 tQ read screen f3 hardcopy 


The ’hardcopy’ refers to printed copy. Simply press the f3 function 
key on your Commodore 64 to send an image of your screen design 
to your printer. 


RECORD— As we get more specific, we use the term RECORD. 
Thus, within a stamp collection FILE, information about a certain 
stamp would appear in a RECORD for that stamp. Within a 
receivables FILE we would find RECORDS of the individual 
companies or people who owe mon^. 

FIELD— The FIELD Is the most specific Information. Within the 
stamp collection FILE, the RECORDS for individual stamps would 
contain FIELDS of information like; the color of the stamp, the 
country of origin, etc. 


ONIY ONE LIMITATION—You may NOT use column 40 of your 
screen as part of your screen design. The cursor position indicator 
(second line from the bottom) will let you know when you’re in 
this column. Put NO screen information there. 

That’s really all there is to writing on the CODEWRITER screen. We 
will cover all of the information on the current screen as we 
prxeed with the example program. For now, just remember the 
instruction screen is there to help you. Press RETURN. You’ll see 
another instruction screen. This, too, wlU be covered in our 
example program. Again, remember the screens are there and 
press RETURN. 

DESIdHING THE PROGRAM S0R1EH 

You should now be looking at an almost blank screen, the 
CODEVvRITER screen is 40 columns across and 22 rows top to 
bottom. You should see the cursor at the upper left and two hnes 
at the bottom of the screen; 



The Col/Row line will TRACK the cursor position on the screen. 

Try using the cursor keys we described earlier. Watch the 
numbers on the Col/Row line change as the cursor moves. This 
CODEWRITER feature helps in counting positions when designing 
your screen and is very valuable when you’re trying to copy an 
existing form to the screen for use in a program. 

Before we begin our example program, we need to understand a 
few terms about the way computers handle information. The 
terms are FILE, RECORD, and FIELD;_ 

CodeWriterlfM 


Don’t be discouraged if everything you read is not clear the first 
time through We have tried to keep computer jargon to a 
minimum in this manual, but a little is bound to creep in. If you 
work through the example program, things will begin to come 
together. 

Your CODEWRITER form screen is a remarkably flexible tool. 
Getting information into your program, in the order you want and 
the language clearest to you should be easy. Don’t be afraid to 
experiment. You may use as many as 100 fields on a screen. Just 
type anywhere (except col. 40)—YOU CAN’T HURT CODEWRITER 
OR YOUR COMPUTER FROM THE KEYBOARD. 

A SALES/mVOIGl PROGRAM 

Our example program is intended to keep track of sales. We chose 
this program idea because it gives a good indication of what the 
CODEWRITER system will do. To use our new vocahilary, we wish 
to build and keep track of a FILE of sales over a certain period of 
time. Each sale will be entered to a screen RECORD known, 
naturally enough, as an invoice. Each invoice will contain FIELDS 
to put the most specific information like; customer name, item 
purchased, date, price paid, etc. 

We should give our invoice form some kind of heading or label to 
show what its use will be. The example in the shaded box below 
uses an up arrow ( 4 ) as a SPECIAL MARKER on either side. 
Your computer may use another character. Check the screen 
Instructions. 





I ABC COMPANY SALES INVOICE \ 

i 

1 



What you have typed is known as a LABEL to the CODEWRITER 
system. A LABEL is something written which is NOT associated 
with information to be entered. Things like our title (Just 
entered), copyright information on the screen, instructions for 
the program operator, dotted lines and the like are all LABEIB to 
the system because they DON’T ASK ANYONE TO REACT BY 
ENTERING INFORMATION. 
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As you see our label example has the up arrow ( 4 ) symbol on 
either side. This identifies screen information as a LABEL. The up 
arrow key on your Commodore 64 is the second key from the ri^t 
on the second row from the top. Even if screen material is simply 
a line as below: 

f-1 

be sure to use UP ARROWS on BOTH SIDES. 

By the way, don’t be concerned if the invoice label jmu just typed 
is not centered exactly as you wish. We’ll take care of things like 
that later, 

THl PROMPT 

Now for the part of our sales invoice screen that IS concerned 
with information handling. Let’s add some customer information 
PROMPTS to our form. A PROMPT asks for mPORMATION TO BE 
ENTERED. A PROMPT is always followed by at least one dot (.) or 

a dotted line (.) to indicate HOW MUCH SPACE is 

available to enter the information requested by the PROMPT. 

Thus we could add customer information PROMPTS to our sales 
invoice screen and it would look as follows: (Don’t worry about 
typing exactly.) 



There are several things we should notice about PROl^^PTS. As you 
can see, there are no UP ARROWS. For the CODEWRITER system 
to recognize your PROMPTS as the requests for information they 
are, never use UP ARROWS. Also while each PROMPT must have a 

dot (.) or dotted line (.) following it, the dots DON’T have 

to come IMMEDIATEIZ AFTER the letters or numbers in the 
PROMPT. 

Look at the PROMPT ’Customer name’. After the final ’e’ in ’name’, 
there are TWO SPACES BEFORE the line of dots begins. This allows 
you to create screen forms which are easier to read because the 
PROMPT for information needn’t bump right against the 
information itself. 

In any of your screen designs, the number of DOTS which follow 
the PROMPT determines HOW MANY characters of information 
(letters, numbers, symbols or spaces) may be entered to answer 
that prompt. 


r 
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CODEWRITER CONCEPT 


THE PROMPT—A PROMPT is a request for information by the 
program designer. It is always followed ty a dot or dots to indicate 
length of entry. It NEVER contains up arrows. The CODEWRITER 
system will search for the FIRST DOT following a PROMPT and 
store the information which follows as the response to the 
PROMPT. The total number of dots following a PROMPT should 
never be more than 38 when using your 40 column CBM 64 
computer. 

There is one more tip concerning PROMPTS: Never put a dot (.) 
into the PROMPT itself. This can happen where a PROMPT involves 
an abbreviation as in- 

Max. amount needed? (y or n) 

This is simply a PROMPT asking for a yes or no (one letter) 
response to the question ’Maximum amount needed?’ Can you see 
what’s wrong? The CODEWRITER system will see the dot after 
’Max’ and consider ’fto’ alone to be the PROMPT with a one^ot 
response (Max.) CODEWRITER would then read further (from 
’amount needed’, etc.) and consider this to be a second PROMPT. 
Abbreviation is O.K. Simply leave out the period as in- 
Max amount needed? (y or n) 

This will work fine. 

DATE ENTRY 

The CODEWRITER system handles dates as a special kind of 
response to a PROMPT. You may use either the American date 
format or the European and CODEVIRITER will automatically write 
code to check for the appropriate format and a valid date entry, 
i.e. no July 40 or February 29 (when not a leap year), Formats 
are as follows: To express the 15th day of June, 1983 

American European 

06/15/83 15/06/83 

For now simply enter the empty date format. CODEWRITER will 
ask for the American/European choice later. 


Added to our current screen this would be: 













Add the date PROMPT to your screen. Whenever you wish date 
information to be entered into your CODEWRITER created 
programs, use the format. The PROMPT may be 

whatever you wish as; 

Order Date 
Member since 

Date to Close ../••/.. etc. 

Only the actual date entry format need be the same. When the 
operator of your program enters a date, it will be as 02/05/81— 
(You may type SPACES instead of leading zeros.) Later on in 
program development you will be offered the choice by 
CODEWRITER as whether you wish American or European format 
date handling. 

HUMB2HS 

Up to now the information required by the PROMPTS on our sales 
invoice screen has been what your computer considers 
ALPHANUMERICS—jargon meaning IDEAS expressed in letters 
and numbers. For example a name, an address, and a date are all 
ALPHANUMERICS because of two things; They can be expressed in 
letters and numbers AND they are NOT USUALIY part of any 
CALCULATION—you don’t adi subtract, multiply or divide them 
even though they MAY include numbers. 

NULOIRIGS, to your computer, are different. In the CODEWRITER 
system NUMERICS have two meanings of their own; They involve 
NUMBERS ONLY, never letters, and they can be included in 
CALCULATIONS. As we promised to avoid jargon, let us begin here 
to refer to NUNIERICS as simply numbers. 

As we add a nev/ line to our sales invoice screen you’ll notice a 
change; 



See the new symbol? After the 5 dots following ’Quantity ordered’, 
we’ve added the # sign. This does two things; The # sign takes the 
place of a dot, making the space for information total 6, and the * 
sign teUs the CODEWRITER system that the information to be 
entered wiR be NUMBERS and ONLY NUMBERS. Thus the numoers 
may be part of a calculation—if the program designer wishes. 




by now your program screen should look like the one a^lknd 
include the new NUMBERS field for ’Quantity ordered’. iS add 
another field to the screen. 


I ABC Company Sales Invoice j 


Customer name 
Street address 


Quantity ordered 


As you see, we’ve added another ALPHANUMERIC field called 
’ITEM’ and given it 16 spaces for operator entry. Again, we didn’t 
need any symbol after the row of dots. Add the new field yourself. 

Now it’s time for a little ’housekeeping’. As we look at the latest 
line on our sales invoice screen, it looks as though space is 
running out too soon. Most invoice forms allow for ’Quantity’, 
’Item’, ’price each’, and ’total’ all on a SINGLE- LINE. Tne 
CODEWRITER system allows ANYTHING on your form to be 
retyped as often as you like until it’s just as you wish. Why not 
take advantage? 


I ABC Company Sales Invoice f 


Customer name 
ffi Street address 


There. We’ve abbreviated ’Quantity ordered’ to ’Quan’ (no period) 
and added space to the ’ITEM’ PROMPT, allowing for a better 
description of ITEM. 

MONEY 

The last type of PROMPT field CODEWRITER offers is for MONEY. 
This field type simply stores numbers for all DECIMAL TYPE 
CURRENCIES for a maximum of 2 places to the right of the 
decimal point. The CODEWRITER program designer adds the $ sign 
(the meaning here being ’money’ rather than the American 
dollar) to the end of the dotted entry line. 


We can now complete our sales invoice form; 





















Look at the four new PROMPT fields before you type them onto 
your screen. The PROMPTS Trice’, ’Total’, and ’Tax’ are simple 
MONEY fields. Trice’ calls for an entry of 7 characters (6 dots 
and the S sign). ’Total’ allows for a 7 character entry (6 dots and 
the S sign), and so does ’Tax’. The PROMPT for ’Invoice Total’ 
may be confusing Here the PROMPT ITSELF ends in the S sign. 
This is perfectly O.K. as long as you’re careful. 

For ’Invoice Total S’ the trailing S sign in the PROMPT simply 
allows the final form of the MONEY entry to read: 

Invoice Total $ 125.75 instead of 
Invoice Total 125.75 

This is a purely cosmetic option for the program designer. As a 
trailing sign, of course, the S symbol could be ANY symbol 
appropriate to the currency you are using. Only the S sign at the 
END of the dotted line MUST be the $ sign as this is what tells 
CODEWRITER it’s handling MONEY. 

As you can imagine, you need to be especially wary of accidental 
dots in your PROMPTS where MONEY is involved. 
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PROMPT FIELD TYPES 

ALPHANUMERIC (letters, numbers, symbo]B)~-need NO special 

sign at the end of the dotted line. Ex. Name.Th^ 

CANNOT be a part of a calculation. 

DATE— may use ANY PROMPT but MUST use the input form 
../../.. as in Member since ../../.. They CANNOT be part of 
a calculation. 

A GENERAL CAUTION— Do not use the comma (,) colon (:) or 
semicolon (;) as part of your screen designs. These symbols 
confuse the file handling operations of both your CODEWRITER 
system and your CBM 64. To prevent problems, these k^s are 
DISABLED when CODEWRITER is in use. 

NUMERIC (numbers only)—may use ANY PROMPT but LfUST 
use the # sign at the end of the dotted line. Ex. Amount 
.# They CAN be part of a calculation. 

MONEY (numbers only)—may use ANY PROldPT but MUST use 

the S sign at the end of the dotted line. Ex. Price.S They 

CAN be part of a calculation. 

BOTH A NUMBER AND A MONEY field need at least two 
characters to define their length. For example, the fields CASH 
PAID .$ or NUMBER USED .# both have two characters (the dot 
and the sign) following the prompt. Use at LEAST two. 
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I ABC Company Sales Invoice | 


Customer name 
Street address 


Price .S Total 

Tax 

Invoice Total 


PAID ON ACCOUNT 


S INVOICE BALANCE 


TOTAL ACCOUNTS RECEIVABLE 


The six new fields each have a specific job. Here’s a look at them 
one by one: 


This allows each ABC Company customer to have his own 
identity—even if names are alike. We have allowed for 5 places. 
Notice there is no # si^ after the dotted line. There are two 
reasons for this; First the # sign would limit us to NUmERS 
ONIY. Some account numbers use both letters and numbers 
(as T1450 etc.) to give greater variety using the fewest places. 
Secondly, using the # sign requires a bit more computer memory. 
Whenever CODEJWRITER sees this sign (or the S), it holds extra 
computer memory space aside in case the information in the field 
would be needed for use in a CALCULATION. Since we aren’t likely 
to use account numbers in any calculation, why not save 
computer memory? 


Here is our screen with the six new fields: 


Our sales file can be much more than an electronic 
invoice system. Let’s get down to some real PROGRAM 
DESIGN. By adding six additional fields to our screen, 
the CODEWRITER sales program can become a very 
efficient CREDIT JOURITAL while giving up to date 
reports on both TOTAL ACCOUNTS RECEIVABLE and 
TOTAL SALES. (Not bad for a first effort!) 


Acct # 
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Invoice # 


This five-place field identifies a PARTICULAR SALE to our ABC 
Company Customer. By using BOTH the Acct # AND this Invoice 
we allow our CODEWRITER program to group together, in its 
memory, ALL the sales to the SAME Account number. We’ll show 
later why this helps. Again, we left off the If sign (for the same 
reasons as the Acct If example above). 


PAID ON ACCOUNT 


This seven-place S field will be used to record customer payments 
against the particular invoice which is on the screen. We used the 
S sign because money is involved AND because this field WILL be 
used in a calculation. We’ll explain the calculation function later. 


INVOICE BALANCE 


This field will hold the DIFFERENCE between the amount shown 
on screen as ’Invoice Tbtal’ and ’PAID ON ACCOUNT’. Again, the S 
sign is used because this field will always involve monev. 
we’ll use ’INVOICE BALANCE’ as part of a calculation. Our 
CODEWRITER program will be designed to calculate this amount 
automatically. 


TOTAL ACCOUNTS RECEIVABLE 


This $ field is intended to gve a RUNNING GRAND TOTAL of aU 
the balances carried in the field ’INVOICE BALANCE’. We have 
placed this field on the screen below the ===== header line to 
help show that the amount is a total of ALL the invoices in the file 
rather than the particular invoice on the screen. 


TOTAL SALES 


Again, this S field is a FILE WIDE GRAND TOTAL of ALL sales 
rather than relating to the invoice on the screen. We’U show later 
how to design CODEWRITER programs to perform the grand total 
function. 

Our sales invoice is now complete. Of course a real sales invoice 
would have more lines to enter sales items and prices, but for our 
example this is enough. You are perfectly free to a4)u8t the screen 
until your invoice form looks as close to our example as you wish 
to follow the manual. 
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Now the real ma^c of CODEWHITER will come clear. You have 
been asking yourself “What does drawing a screen form have to do 
with writing a program?” The answer in the CODEWKITER system 
is “almost everything”. CODEWRITER will “read” the screen we 
have Just created and develop AUTOMATICALIY the entire file 
structure needed to make our program run. All the PROldPTS will 
be saved in the right places. The 'dates’ will be saved as ’dates’, 
’money’ as ’money’, etc. Most of the program designer’s work in 
creating this program is over! 
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Once you’re satisfied with the screen on your computer, press ESC 
to begin the “reading” we Just spoke about. The screen will go 
blank for a moment and our sales invoice form will be replaced by 
the words “READING SCREEN”. In a moment our screen vhll 
return. 

Certain PROMPT fields on the screen will be fflGHLIGHTED in 
REVERSE and a question will appear at the bottom of the screen. 
CODEWRITER will skip over any LABELS, date and ALPHANUMERIC 
fields we’ve created and ask questions only about fields which 
contain NUMERIC and MONEY information. 

The program designer is asked here whether a particular 
PROMPT field is to be “keyboard entered” or “program calculated”. 
This simply means: “Do you wish to have the program operator 
enter the information the PROMPT requests or do you wish to 
have CODEWRITER itself calculate the response?” 

NOTE: The third choice, g for GLOBAL, allows your CODEWRITER 
program to accumulate TOTAIB from ALL the records in the file. 
More about this later. 


In our sales invoice example answer the following as the fields are 

fflGHLIGHTED in REVERSE: 

Quan enter ’k’ The operator must enter this 

from the (k)eyboard 

Price enter ’k’ 

Total enter ’p’ The CODEWRITER (p)rogram can 

calculate this amount by 
multiplying “Quan” times 
“Price”. Why make extra work 
for the operator. 

Thx enter ’p’ As long as the sales tax rate is 

constant for all items, your 
CODEWRITER created program 
TTill recall the rate as a 
percentage and multiply this by 
the “Ibtal” 
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Invoice Total S [enteTy] CODEWRITER will wrHiogram 
lines to direct the adding of 
“Total” to “Tax” 

PAID ON ACCOUNT enter ’k’ The program operator will enter 
this amount. 


INVOICE BALANCE enter ’p’ Your CODEWRITER (p)rogram 
will calculate this 


TOTAL ACCOUNTS 

RECEIVABLE enter ’g’ for this (g)rand total. 

TOTAL SALES enter ’g’ j CODEWRITER will ACCUMULATE 
the Invoice Total amounts and 
show the TOTAL whenever the 
operator looks in the SALES FILE 


Once all the appropriate fields have been designated either “k”. 
“p”, or “g’ ty the program designer, CODEWRITER wiU return to 
the Screen Format Generator menu where the following choices 
are offered 



For now, do NOTHING. Here is what the menu options mean: 

EDIT SCREEN FORMAT—If the program designer wished to make 
ENTRY CHANGES in the screen, he would use this option. By 
ENTRY CHANGES we mean changes in the KIND of information to 
be entered, such as adding or subtracting a PROMPT, or in the 
SPACE allowed to respond to a PROMPT. 

Once the ’e’ for edit is selected, the current screen in memory will 
re-appear. CODEWRITER will then allow ANY changes to be made 
to the screen as though it had Just been typed in. All ’k’ or ’p’ 
choice information needs to be RE-ENTERED before leaving the 
Edit Screen option. 

CHANGE SCREEN FORMAT—This option is strictly for MOVING 
existing screen information around No new fields may be added or 
existing fields or labels removed More about “Change Screen” 
later. 
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SAVE SCREEN—This option allows the CURRENT screen in 
memory (the one we just created) to be saved to the disk in the 
second drive. More about “Save Screen” later. 

LOAD SCREEN—This option allows a previously saved screen to 
be loaded from the disk in the second drive. Thus ALREADY 
CREATED programs made with CODEWRITER could be modified 
later 1^ loading Just the screen with this option and then going 
back to the Edit Screen Format option to continue creating a NEW 
program. To simply VERIFY proper screen save, Change Screen can 
work better. More later.' 

EXIT TO SYSTEM CREATION—This option starts things over from 
the beginning. BE CAREFUL HERE! If you choose the exit option 
BEFORE saving your screen, the screen will be LOST. 

Even though our current sales invoice screen shouldn’t need any 
changes, let’s choose the CHAJ^GE SCREEN option an}^ay—Just 
to watch how well it works. 



You should see an instruction screen to explain the v7orkings of 
“Change Screen”. This is for future reference. Read over the 
screen and then press RETURN. 

Once again the sales invoice form should appear. The LABEL 
I ABC COMPANY SALES INVOICE 4 should have the cursor at the 
FIRST POSITION. Let’s say you weren’t satisfied with the way the 
LABEL was centered on the screen. Press the RETURN key and 
the LABEL should change to REVERSE screen image. 

A field SHOWN REVERSE this way is ready to be MOOTED. Simply 
use the four cursor k^ 7 s and move the LABEL anywhere on the 
screen you wish! Should your moving label bump into another field 
on its Journ^ around the screen, CODEWRITER vhU automatically 
JUMP the label to the next empty area in the direction it was 
being moved Once you’re satisfied with the position of the moving 
field simply stop and press the RETURN key. The field will revert 
to the normal print mode from REVERSE. ALL screen fields can be 
moved in the same way. 

Press ANY key (except RETURN) and you’ll skip to the next field 
where the process can be repeated as often as you like. Wfith each 
pressing of a k^ the cursor will move to the beginning of the next 
field The cursor will move over the fields in the SAME ORDER in 
which the fields were FIRST ENTERED. Check your screen 
instructions for the correct method to BACK UP through 
preceeding fields. 



Making “Ciianges” can lead to some confusion. Rememl^^e 
Change Screen routine does NOT alter any of the logic orae 
screen CODEWRITER has already read Thus, if you move the 
fields all over the screen, your CODEWRITER program will 
continue to prompt for the operator information in the SAME 
ORDER in which you FIRST typed the fields in. If you’d like the 
NEW screen positions to dictate the NEW order of operator entry 
of data, you’ll need to “read the screen” AGAIN with the Edit 
Screen option. 

To make permanent changes with Change Screen, one should 

I Move the fields around any way you wish from Change Screen. 

2. Once changes are complete, press ESC to return to Screen 
Format Generator. 

3. Choose Edit Screen and your NEWIY ALTERED screen will 
appear. 

4. Make any ENTRY CHANGES (see Edit Screen) you wish to 
further alter the screen if needed 

5. Step through the ’k’, ’p’, or ’g’ choices again. Once complete, 
you’ll be back to the Screen Format Generator menu. 

6 . Choose “Save Screen” to save your new form permanently to 
the CODEWRITER disk work space. NOTE; If you have already 
saved a screen in an OLD order and now wish to save the 
screen with NEW field positions, give the NEW screen a NEW file 
name. 

As we don’t require any permanent changes to our example 
program, press fl to leave the Change Screen option. Here 
CODEWRITER warns us to be sure to save the screen. Once back 
at Screen Format Generator, we are ready to save our sales 
invoice screen. 



CODEWRITER will ask the program designer to give a NAME to the 
screen. A maximum of 10 characters is allowed and, as usual, 
simple, appropriate names are b^t. In this case, the name of the 
screen becomes the name of the PROGRAM to be created by 
CODEvVRITER. Do NOT use a slash (/) or a dot (.) as part of a 
screen name. Also, a screen file name must be lower case. 
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’invoice’ so; 
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type ’invoice’ and press RETURN 

The disk in the drive should spin and stop. Next the screen format 
Generator menu appears. We could choose Edit screen to see our 
newly loaded screen, but this would force the ’k’ and ’p’ choices 
a^ain. Instead we choose Change Screen: 

press ’c’ and RETURN 

From Change Screen we are shown our sales invoice form again 
which proves it has been saved correctly. Tb exit Change Screen 
we press the fl. key. 

Screen creation is complete and we may now continue with 
CODEWRITER program design. 

press ’x’ and RETURN 


We get one last warning to save our screen. Quite a worrier, that 
CODEWRITER! 

CREATE DATA ENTRY SYSTEM 

From the current menu m have the choices: 


s create screen layout 
a create application 
X return to Main Menu 




press ’a’ and RETURN 

CODEWRITER now announces that it will ’’produce the basic code 
for a program you design”. You may now enter a name (maximum 
25 characters) and press RETURN. (The name will follow the 
credit: PROGRAM D^ign by ) 

You are next asked for the name of the screen file. Be EXACT here 
so the system can find our much maneuvered screen: 


enter ’invoice’ and press RETURN | 
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Alter a bit of whiiu‘ing from the drive, the sales invoic^® 
screen should re-appear with a few changes; The arrowSround 
the LABEL ABC COMPANY SALES INVOICE should be gone. Also, 


any fields we designated (p)rogpam calculated should have only a 
single dot following the PROMPT. You’ll be asked: 



Is this your screen formal (y/n)? 


If the screen you see is correct 



If you press ’n’, you’ll be returned to the request for “screen file 
name” for another try at finding the screen file. 

WHICH DRIYl FOR DATA 

On your Commodore 64 single drive CODEWRITER system, the 
prompt “Which drive for data DOES NOT appear. You’ll be hearing 
soon how to upgrade your CODEWRITER 64 system to use more 
than one drive—for considerably more file space and power. We 
have the reference in the manual for the future. You may 
continue here if you like or SKIP to page 22. 

The choice is important. Remember, you are now creating a data 
entry program to control information. The information itseh (the 
data) need NOT be on the same disk as the program which 
controls it. Keeping the control program on one disk and the data 
on another MAXIMIZES the amount of data you can control. On 
the other hand, where disk capacity is enough and the 
convenience of both program and data on a single disk is 
important, a one-disk system works fine. 

Remember, the question means “which drive for data” when your 
PROGRAM IS COMPLETE AND RUNNING. (Users Tsith two-drivi 
CODEWRITER systems will NOW have their program disk in thi 
second drive, but it will RUN in the first drive when it’s fiTiiAhtrf 
The “data” can be on either the first or second drive.) 

For our example prog?am, enter the appropriate number for the 
FIRST DRIVE. 
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The next CODEWRITER request will be to define what kind of 
GRAND TOTALS we want in the program being designed In our 
example, the prompt screen will say: 



What does all that mean? When we first designed the screen for 
our sales invoice, we included a total of 14 different FIELDS. We 
then specified which of the information inputs would be 
(k)eyboard entered, which would be calculated by the (p)rogram, 
and which wmuld be a (g)rand total of some other field 

The CODEWRITER system is now ready to learn hovr the program 
designer wishes to CALCULATE the information on the screen. To 
make things easier, CODEWRITER has ABBREVIATED the names of 
the screen fields. Thus the FIRST field on the screen to be 
designated (k)^board (e)ntered becomes kel, the second becomes 
keS, and so on. Naturally enough, the first field we chose to 
designate (p)rogram (c)alculated becomes pci to CODEWRITER. 

Now, back to Grand Totals. CODEWRITER is asking which screen 
field is to be accumulated and displayed as a Grand Total after the 
prompt “Total Accounts Receivable”. Inside the parentheses are 
the choices: kel to kelO, pci to po4. or ’list’. 

Since it’s difficult to remember WHICH field we designated as the 
FIRST program calculated (pci), etc. CODEWRITER offers the ’list’ 
option to display all our choices. 


Type ’list’ and RETURN 


r 
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Keyboard Entered Fields: 
kel= Customer Name 
l(e3= Date 
ke5= City 
ke7= Quan 
ke9= Price 


ke2- Acct H 
ke4= Street Address 
ke6= INVOICE # 
ke8= Item 

kelORAIOON INVOICE 


program calculated fields; 

pc)= Total 
pc3= Invoice Total 


pc2= Tax 

pc4= INVOICE BALANCE 


gtl= TOTAL ACCOUNTS RECEIVABLE gt2- TOTAL SALES 


lou siiouiu now see uie ionowing on ihe screen: 


Again, back to the CODEWRITER prompt we’re trying to answer. 
We want our program to make it easier to get useful information. 
Which of the screen prompts we designed will ADD UP TO a 
GRAND TOTAL we can call “TOTAL ACCOUNTS RECEIVABLE”? 
Study the list. “Invoice Total”? Maybe, but what if we receive a 
payment fi’om a customer? The “Invoice Total” would, of course, 
remain the same after a payment, but the amount the company is 
owed (its receivables) would go down. 

The correct answer is INVOICE BALANCE. Obviously, if we had a 
Grand Total of the INVOICE BALANCE amounts from ALL invoices 
we could caU this figure our TOTAL ACCOUNTS RECEIVABLE. 


The ’list’ should still be on your screen. We can see that INVOICE 
BALANCE is abbreviated ty CODEWRITER to po4. 















Computed field #1 
calculation for Total' 

Type 'list' for field numbers 




This is where you learn to be a Program Designer. Designing the 
screen was the most creative aspect of the job. Now comes the 
real power. 


COMPUTED FIELDS 


The CODEWRITER screen now requests the computations for 4 
computed fields. You’ll be given an entire second screen of 
information as to what this means and an entire screen as to 
what is meant ’self referencing’ fields. 


As before, these screens are reminders for later. We’ll explain the 
procedure here in detail. Read the two screens and press 
RETURN. 


The screen now shows: 


This should now be easy. lype ’list’ again. This time, of course, 
’Invoice Total’ is correct as the amount to be accumulated as 
TOTAL SALES. Press RUTURN to go back to the prompt. 


This tells our CODEWRITER program to accumulate ALL the 
INVOICE BALANCE amounts from the entire file of invoices and 
show the total in TOTAL ACCOUNTS RECEIVABLE on the screen. 
Whenever the operator of our program looks at ANY invoice in the 
ABC Sales file, he or she will always see this grand total on 
display. 


The next CODEWRITER prompt asks for the field to accumulate as; 


TOTAL SALES 


Type iisL to see your choices. As you Iook at the iist^^ompt 
fields and their CODEWRITER abbreviations, think. the 
DEFINmON of ’Total’? In our invoice design. Total’ (pci) means 
‘Quan’ (ke7) multiplied by ‘Price’ (ke9). 

We “design” this definition with CODEWRITER \jy saying 


============ CODEWRITER CONCEPT ============ 

As with most computers, the four basic arithmetic functions are: 

+ means add 
- means subtract 
* means multiply 
/ means divide 

CODEWRITER also allows the use of ( ) to isolate formula 

components. 

Parentheses are used to ISOLATE the calculations Inside them for 
SEPARATE COMPUTATION within a formula. An easy example 
would be: pcl*pc2+(k^-ke5) which means—First multiply pci 
by pc2 and then add to this result the difference between ke3 and 
k05. 

V/hile CODEWRITER will detect SOLIE mathematical errors (such 
as forgetting a closed parentheses after using an open 
parentheses), it CANNOT prevent aU instances of incorrect math 
from getting into a program. You’ll be offered a chance to VERIFY 
a formula after you type it in. Once verified, however, 
CODEVRITER will try to audit what it can and then ACCEPT what 
you wrote. Please be careful. 



Here are the remaining program calculations for our Sales Invoice 
design and an explanation of each Follow the screen commands to 
enter these: 


program calculation 


meaning 


pc2=pc1 *.06 Tax (pc2) is 6% of the Total 

(pci) to the invoice. Thus, we 
multiply pci hy .06 to find Tax. 

pc3=pc1+pc2 Invoice Total (pc3) is simply 

— - Total (pci) PLUS Tax (pc2) 

pc4=pc3~ke10 Invoice Balance (po4) is the 

— -result of Invoice Total (pc3) 

MINUS PAID ON INVOICE (kelO). 























As usual there are a few rules to keep in mind. We’il try to be 
concise: 


I Calculation definitions must deal in KNOWN IDEAS. Thus, you 
cannot enter pc2=pc6-ke3. Can you see why? Calculations are 
defined in the SAME ORDER in which they appear on the 
screen (top to bottom, left to ri^t). Thus, if you are defining 
pc2 you CANNOT have defined already pc6—making pc6 an 
UNMOWN DEA. This quandry is easier to avoid than you may 
think. Simply design your screen so that your input prompts 
PROGRESS in logical order (price before total, payment before 
balance, etc.). CODEWRITER will handle things from there. 

2. Program calculations are the HEART of a good design. Use them 
well They may contain ANY combination of pc fields, ke fields 
and even gt fields (subject to rule 1). They should be limited to 
25 characters in overall length. 




There is a bit more power in CODEWRITER calculations. The Self 
Referencing field may seem abstract and confusing at first, but 
it’s JUST PERFECT for some Jobs. Where the program designer 
wishes to HOLD a PREVIOUS value while calciolating a new one. he 
needs a Self Referencing field. 

An example is in order. In an inventory program, a field named 
BALANCE ON HAND will usually be designed to depend on two 
others like QUANTITY IN and QUANTITY OUT. 

Lets assume that QUANTITY IN is kel and QUANTITY OUT is ke2, 
while BALANCE ON HAND is pci 

If we used a formula like pcl=kel-ke2 (v/hich might seem 
logical), our inventory would be a disaster. Can you see why? The 
field of BALANCE ON HAND would always contain ONLY the 
LATEST results of the CURRENT difference between QUANTITY IN 
and QUANTITY OUT. 

What’s needed for a field like BALANCE ON HAND is a way to 
REMEMBER the current value, hold it, and then COMBINE it with 
a new value. Though many methods for doing an inventory exist, 
one approach might be: 

pc1=pc1+(ke1-ke2) 

CODEWRITER sees this as Self Referencing since the pci appears 
on BOTH sides of the = sign. 

Another use for self referencing is in a pure “counting” field. 
Since all ’pc’ fields are automatically calculated EACH TIME a 
record is looked up by the operator, a field named “Record Access 
Times” (as pc5 for instance) could be designed to count the 
number of times a records vms looked up by defining it as: 



pc5=pc5+1 


CODEWRITER will automatically create a special file for self 
referencing fields whenever it sees a calculation with the SAME pc 
on BOTH sides of the = sign. The program designer needn’t do 
anything but write the formula. 

Because the self referencing file will take extra space on the 
program disk, CODEWRITER will ask the designer to “confirm” 
that this unique field is what the designer truly wishes. Simply 
type ’c’ to confirm as directed. 

REMEMBER—The self-referencing field is for Program Calculated 
(pc) fields only. The CODEWRITER system contains special 
features for AUTOMATIC UPDATING of Keyboard Entered (ke) 
fields. These features are explained later, under “UPDATE DATA”, 
in the instructions for using ANY CODEWRITER designed data 
entry program. Don’t worry if “self-referencing” is not quite clear 
yet. Just keep in mind the following: 

L “self-referencing” means holding an existing value while 
combining it with a new one. 

2. A self referencing field is ALWAYS program calculated 

3. A keyboard entered field can do ALMOST the same thing 
another way. 

One last thing. Once defined, a self referencing field MUST have 
some opening value (even zero) to function. This needn’t be done 
by the designer, but must be done the FIRST time the program 
operator encounters the field on the screen. CODEWRITER 
anticipates this. Should a program operator pass a seif referencing 
field the first time WITHOUT entering a value, the prompt ‘You 
must enter something” will appear at the bottom of the screen. 
Again, a zero entry is fine. 

THE NUMBER OF RECORDS NEEDED 

Once field calculations are completed, CODEWRITER will ask; 

“What is the maximum number of records you want in the data 
file (50 to-)?” 

This calculation is made automatically \jy CODEWRITER and 
depends on the amount of information in a screen design. 
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CuijiliWKiTiilh caicukDes ihe maximuin lor you aiid asks iiow many 
you’re likely to need in your file. CODEWRITER will then reserve 
the correct amount of space on your program disk. Remember 
that specifying the maximum here will FILL the program disk. 
Where you would like MORE than one program on the same disk, 
ask for the FEWEST records practicable for your use. 

For our Sales Invoice example, a small record file Thll do. 


enter ’50’ and press RETURN 


Next, we are directed to ‘"lype in the program title” and are 
allowed 30 characters to do so. The program ’title’ is NOT THE 
SAME as the ‘Screen file name’ we chose earlier. This ’title’ is 
cosmetic only and will merely be printed above the menu 
CODEWRITER will automatic^y create for your programs. The 
’title’ should simply describe what your program DOES. 

Enter something like 


’ABC SALES RECORDS’ 


and press RETURN 
THl KSY fHLD 

You should now see on the screen the following questions: 

“Which field is the key field (type 1 to or ’list’ to list fields)” 

The “key field” is more computer Jargon for a not too difficult idea. 

The program which CODEWRITER is creating from our design will 
store records in a file and then get them back as we need them. lb 
find a particular record (screen), the program conducts an 
electronic ’search’. The program can simply look at every record 
in file until it finds what we need, or it can go MUCH MORE 
DIREUITY to the record in question. 

The difference is having a “key” field to search for. Where one field 
on our screen record is designated the “key”, the CODEWRITER 
created program can go to a SPECIAL INDEX of “keys” it had 
previously set up. In a flash the needed screen appears. 

There is no need for special computer knowledge to choose the 
“key” field. The “key” is simply the one piece of information 
(field) MOST LIKEIY TO BE LOOKED UP when searching a file. 

As an example, in a sales invoice file it is very likely that records 
will be searched by ‘Customer name’ most often. Perhaps, in 
another case, the screen form for the invoice contained a 
’customer number’ or ’account number’. Certainly either of these 
would make a good “key” field as weU. 
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Our choice is limited to the 10 fields designated ’keyboard entered’. 
A ’program calculated’ field can NEVER be a “key”. The 
CODEWRITER system has numbered our fields from 1 to 10 and 
has kept track of the numbers. Thus we can choose the “key” by 
entering the number only. Let’s make ’Acct #’ the key. 


enter ’2’ and press RETURN 


The next screen should read: 


You have 8 dollar fields. 


The screen should explain how to calculate the space to allow for 
dollar fields. Different computer systems allow different 
maximums. 

This response is simple. In fact, we’ve already taken care of it in 
our screen entry. We made the largest money field 7 characters (6 
plus .) and therefore the MOST money we can record in the space 
is 9999.99 Do you see? We need 6 spaces for the NUMBERS plus 1 
for the decimal. As a guide to future formatting, here are a few 
examples of SPACE VERSES AMOUNT: 

7spaces= 9999.99 8spaces= 99999.99 9 spaces= 999999.99 




enter ’7’ and RETURN 


Since many CODEWRITER applications will involve money, we can 
use a bit more advice on the subject. Here are a few tips: 


L CODEVvRITER will allow an operator to enter simply 23. and 
this will print as 23.00 
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in .10 will be printed later as 0.10 

3. \Vbere the program designer wishes to make sure that money 
amounts line up top to bottom with the decimal points EVEN, 
care should be taken to see that the DOITED LINES for money 
justify TO THE LEFT. For example: 

left 

.I (7 places) 

.$ (9 places) 

...I (4places) 

will result in a column of money amounts with the decimals in 
line TOP TO BOTTOM even thou^ the S signs vary. The fact 
that the dotted entry lines are justified LEFT will accomplish 
this. 

4. All ($) money fields, whether Program Calculated or Keyboard 
Entered, need as much space as the LONGEST of them needs. 
Thus where you choose a mon^ field needing Q spaces 
(including decimal), maJie sure EVERY dollar field on your 
screen allow for 9 spaces. 

KEEPING OUT GAKBAGB 

We are almost finished vnth program design. This last section is 
really optional, but it can be quite important. 

Any collection of information can be made most valuable to the 
extent it can be kept PURE. That is a file on stamps should not 
contain an occasional recipe and a PROLOT field for price should 
not allow letters to be typed in, etc. 

Without some attempt at keeping out ’garbage’ entry, a file can 
become an awful mess and lose a lot of its value. 

You should now be looking at the first of two screens which show 
how the CODE\^/RITER system allows the program designer TRAP 
OUT ERRORS in operator entry. 



i 


\ 

I 
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Like the other instruction screens on the CODEWRiTEl^^, these 
are for future reference. Let’s go through them now foflrore 
detailed understanding. 

Once past the two screens, CODEWRITER will bring our sales 
invoice screen back into view and begin to HIGHLIGHT each of the 
KEYBOARD ENTERED fields. At the bottom of the screen there is a 
prompt line saying: Reject if: at the same time as ONE FIELD is 
HIGHLIGHTED above. 

The program designer is being asked, “What will not be accepted?’’ 

CODEWRITER offers a complete arsenal of weapons to keep out 
nonsense and a very good system for letting a program operator 
know when something is wrong. 

In order to best use your Reject if: weapons, we’ll go through the 
entry process together. Remember, you can always type ’help’ to 
see all the types of data traps again on the 2 screens. You 
SHOULD study the screens as we go. 


You’ll see HIGHLIGHTED on the screen ’Customer name 
etc.’ and ’Reject if:’ below. 


1 

1 





enter ’no entry’ and RETURN 

1 




This means that we have DEMANDED SOME ENTRY by the 
operator of our program. Since ’Customer name’ is quite 
important, the operator musn’t leave it blank or the sales record 
could be confusing. 

Once ’no entry’ is typed and RETURN pressed, you’ll see: 



CODEWRITER is asking the program designer to write a message 
to the program operator EXPLAINING that the mistake ’no entry’ 
was made. The “cr= **’ you must enter something ***” means 
that if the program designer wishes, the message “you must enter 
something’’ will be entered AUTOMATICALIY by CODEWRITER as a 
response to the ’no entry’ error, (the cr means (c)arrlage 
(r)eturn or just RETURN) 

Let’s write our own error message: 
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enter ‘You must enter customer’s name.’ and RETURN 


Ab you’ll see the SAME field will remain HIGHLIGHTED and the 
Reject if: message will appear a^ain. Why? Because MORE than 
one error could be made in the same field entry. 

Let’s say we want to prevent an entry which is TOO LONG. The 
’name’ field is 30 spaces. We can use the edit feature of 
CODEWRITER to automatically reject an entry longer than 29 (in 
this case). The rule is; Where you wish to restrict len^h, allow 
the space involved to be at least ONE SPACE MORE than the entry 
you wish to reject. 


Your CODEWRITER program will then reject all entries MORE 
THAN 29 spaces in length. (The symbol after ’length’ above means 
’greater than’.) This prevents an operator from typing more 
information than your screen form can accept. Regardless of any 
edits you provide, your CODEV/RTTER program will automatically 
sound a BELL when an operator tries to type PAST THE BOUNDS 
of your screen format size for a given field (Le. more than 10 
spaces in a 10 space field). 


miMTvm m progham disigh 

The choosing of edits and operator messages to trap out errors is 
where the personality of the program designer really comes 
through. The “attitude” of the created program toward its user, 
and the general need for accuracy, is built at this point. 

Rather than go through all of the fields in our example program, 
we’ll offer, instead, some suggested “edits” and messages. Once 
you feel comfortable with the process of edit control, 1^ ail means 
devise your own. 

Field Name Reject if: (syntax) Meaning Message 

Acct # no entry As the key field, it “Please include the 

MUST be entered Acct #" 

Acct # tength<5 Acct #’s MUST have “The Acct # you 

5 characters entered is too short" 

INVOICE # contains "AB" Invoice # CANNOT “AB series Invoice 

contain "AB" In belongs with West 

1.0. Number territory" 

Ouan not numeric A quantity MUST be "Please express 

entered as a number quantity as a number" 


enter ’customer name cannot be over 29 spaces’ 
and RETURN 



enter ’length) 29’ and RETURN 


Price 


> 10000 


No number OVER 
10.000 will be 
accepted 


"Hems costing over 
SI0.000 use form 3" 


(Noie: Though the following aren't m our example pr^A, th^r 
help to illustrate the edit process.) 


Last Name > "0” No name beginning "This form for A to C 

with 0 or later will names only" 
be accepted 

Part# =^300 Don’t accept 300 "Item 300 has been 

dropped-see note 10” 

SEX <>“male" MUST be male “Use male only for this 

survey" 

WARNING: While edits can be COMBINED to test the SAME field for 
different kinds of operator errors, some combinations are 
LEATHAL—as they allow no entry at all (or eliminate a range of 
entries by mistake). For instance, >“a” rules out EVERY lower 
case letter entry. (Can you see why?) And)IDO, when combined 
with <50, allows ONIY 50 to 100 to be entered. 

By studying these examples as well as the two edit screens, you 
should be getting a good idea of the editing process. Remember, 
CODEWRITER will process as many or as few information edits as 
you wish. Don’t leave edits out entirely, though, as they can be 
the “soul” of a good information file. 

PLEASE NOTE; If the “reject ifj” syntax is still not clear, see 
Appendix A at the end of the data entry section in this 
manual. 

Once the edit section is complete, CODEWRITER asks if you would 
like a special “end of data entry” message to be used in your 
program. This message allows the program operator to either get a 
new blank screen form to fill in or return to the program menu. 

The Program Designer is free to choose his own language here, but 
ONE bit of program LOGIC is automatic: If the operator presses the 
RETURN key at the end of filling in a screen, a NEW SCREEN will 
appear. And if “y” or ’yes’ is entered, the program STOPS DATA 
ENTRY and returns to the menu. Examples of “legal” messages 
are: 

“Are you ready to stop data entry y or n (RETURN = n)” 
or 

“To return to the Main Menu press ”y”, to continue press 
RETURN” 

If you’d rather not bother to compose any special message, simply 
press the RETURN key and CODEWRTTER will write its own 
message as shown on the screen. 

This final CODEWRTTER design choice is for date format. 

Enter an 'a’ for American or ’e’ for European date 
format in your program. 
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Any neiQyou aesignaiea date (by entering . j. .i.. to liie 
screen) will automatically be evaluated by CODEWRITER for 
legal date entries. 

THAT’S IT! 

Once the correct date format has been entered, your GODEWRITER 
64 system is ready to begin turning your program design into 
BASIC computer axle. 

LfOave the CODEWRITER disk in the drive. You'll see a screen 
which lets you know CODEWRITER has created a special text file 
with your new program in it. The program must now be converted 
to a standard BASIC program 

The process of turning your program design into a working 
program may take from 25 minutes to a bit over an hour. Don’t be 
concerned about the time. It’s all AUTOMATIC from here. 
CODEWRITER does all the work. You may' watch the lines of BASIC 
code scroll to your screen—or Just walk away. 

Be sure, however, that during PROGRAM CREATION no one turns 
the computer off. This CAN happen. Since your Commodore 64 is 
doing a lot of work, there will be times when the screen will be 
ENTIREIY BLANK (between new program lines). Thus, it is 
possible for someone to think the computer is not in use. A lot of 
your design work would be lost. 



Once your new program has been converted to BASIC by 
CODEWRITER, you’ll see a screen telling you the process is nearly 
complete. You’ll be told to REMOVE the CODFWRITER disk from the 
drive. Store it in a safe place. Next you’ll need the formatted disk 
which will be used to SAVE your new program. Place the 
formatted disk (your work disk mentioned on page 4) in the drive. 



A short program will now do some last minute disk 
“housekeeping” on your new program (now loading onto your 
disk). This will take no more than one minute. Now the process is 
over. Your program will be ’saved’ automatically onto your disk by 
CODEWRITER. 

To run your program immediately simply type: run and 

press RETURN. Later, you run the program like any other piece of 
software—there is no further need for CODEWRITER until your 
next program design. Simply place your disk in the drive (after 
proper power up). The ’program name’ is the name of your 
SCREEN FILE plus a /t. For example, if your screen file is named 
Joe your program name vnll be Joe/t . Both the screen file name 
and the t MUST be lower case. 

The correct sequence for running your new software (once you 
have turned your computer off) is the following (We’ll assume the 
screen file in named Joe ): 



NQiE: Wnere you have already created a program with 
CodeWriter jou can load it into your computer’s memorylBny. 
First, find what’s on the disk (load “I”, 8 then ’list’). You’ll see a 
series of files with the same screen file name (but different 
suffixes). The ’/T file is the one to load For example, our ’invoice’ 
program would be loaded 





type load “invoice/T,” 8 





(Naturally, if you used a different “screen file name”, substitute 
that name in front of the ’/t’ in the directory file name.) 


Once the flashing cursor returns to the screen: 





type ’run’ and press RETURN 





After a bit of disk activity, the Main Menu of your first 
CODEWRITER program should appear. Except for your name being 
used instead of ours, it should look like this: 



Let’s go through the menu options one at a time. 


File Preparation—This is the CODEWRITER utility which 
prepares the disk designated to hold the data for the program. The 
File Preparation utility will create enough disk space on the data 
disk to hold the file the designer had requested REMEMBER! This 
utility is used ONIY the FIRST TIME a program is run. Once there 
is data on a disk, the File Preparation utility will ERASE it to 
’Prepare’ a new file. Beware! 
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Bntar diU—This gives the program operator a new and empty 
screen form to fill in. At this point ONIY the KEYBOARD ENTERED 
fields are displayed (not program calculated grand total or 
labels). To stop the ’Enter data’ sequence mid-screen, press the 
fl key. Once a screen is complete, the operator will see a line 
showing how many records have been entered into the file and 
how many are left. Next the operator is asked whether the data 
entry session is complete. If not a new screen is shown. If so, the 
program returns to the MENU. 

Update data— This program routine gives the operator a chance 
to change any information already entered into a screen record. 
The operator is asked to give the “ke/” information-that is the 
data entered in the field designated “k^” ty the program 
designer. Here’s an example: 

In our ABC SALES program, the “k^r” field is ’Acct Thus, on 
Update the operator first sees a prompt asking for the ’Acct #’ of 
the record to be ’Updated’. Once the Acct H of the record (invoice) 
is entered and RETURN is pressed, the program searches the disk 
for the record and displays it on the screen. 

At the bottom of the screen, the prompt line displays: 


If the record displayed is correct, press RETURN. You’ll notice 
that now ALL FIELDS and LABELS are displayed. The results of 
program calculations appear and grand totals are listed where 
they were designed. (NOTE: If the record displayed is not correct, 
ty^pe ’n’ and the program will continue to search.) 

A new prompt now appears at the bottom of the screen. Using our 
Invoice Program as an example, the prompt reads: 

Which field to update (1-10, ’list’, CL to cancel RETURN to save) 

The prompt choices. Inside the parentheses separated by commas, 
mean the following: 

1-10—This is a choice of field numbers to UPDATE from field #1 to 
field #10. M are KEYBOARD ENTERED fields (the ONLY ones 
intended by the program designer for the program operator to be 
involved with). 

list—Naturally, this gives the operator a list of the KEYBOARD 
ENTERED fields showing which FIELD LABELS belong with each of 
the 10 numbers. Once the operator sees which field # needs to be 
UPDATED, RETURN is pressed, the record screen returns, and the 
update is ready for a choice. 


Fl—At any time during UPDATE, the operator may and 

cancel the update process. This returns the main meni^ 

RETURN—lb COMPLETE and SAVE the update to disk file, press 
RETURN. 

This sequence illustrates the update process on our example 
program: 

L The operator notices that an incorrect price was used in a 
customer invoice already on file. 

2. The UPDATE routine is called with “u” and RETURN. 

3. The Acct #, 1005, is entered as called for. 

4. The first record displayed is the right Acct # but the WRONG 
invoice, so ’n’ and RETURN get a second invoice—which is 
correct. 

5. ’List’ is called to get the field # for ’Price’, which is 9. The 9 Is 
entered and the cursor appears at the ’Price’ field—now erased 
and waiting for a new entry. 

6. As soon as the new price is entered and RETURN is pressed, 
the screen action begins! Not only is ’Price’ updated, but ALL 
the program calculated fields and grand total fields which in 
some way depend on the price amount are also updated and 
can be saved by pressing RETURN again once the revised 
screen appears. 

Before we leave the UPDATE routine, there is one more valuable 
feature called “(ni)ore and (l)ess”. Here’s an example from our 
ABC SALES program: 

L A customer wishes to make a payment on one of his open 
invoices. The operator goes through the update routine and 
finds that the field (#10) PAID ON INVOICE alreac^y contains a 
payment amount. The customer is making a second payment on 
the same open invoice. 

2. Since in this case we don’t want the amount NOW in PAID ON 
INVOICE to be ERASED and replaced with the current payment, 
the normal update won’t do. (Let’s say the amount currently in 
PAD ON INVOICE is 115.00) 

3. The operator chooses field #10 which places the cursor at PAD 
ON INVOICE and OVERWRITES the $15.00 amount. Since the new 
payment is $10.00 and we wish to ADD this amount to PAD ON 
INVOICE, the payment is entered as 10.00m for more. The’m’ 
ADDS the 10.00 to the previous 15.00 so when RETURN is 
pressed, the new PAD ON INVOICE amount reads 25.00 and 
once again all fields which relate to this change automatically. 

Obviously, entering ’1’ (for less) as in 35.001 would SUBTRACT 
35.00 from the amount already entered. 








One last point; Tne m and 1 feature at first seems the same as a 
seif referencing program calculated field which holds an old value 
while calculating a new one. The two are different. The m and 1 
feature works ONLY on KEYBOARD ENTERED fields while self 
referencing is ONLY for PROGRAM CALCULATED fields. 

Keep “(m)ore and (l)ess’ in mind for your future CODEWRITER 
applications. The feature is invaluable for inventory type 
programs especially. 

Look up record— When'the T’ is used from the main menu, the 
user first sees the key field alone on his screen. The ENTIRE key 
field entry should be typed and then RETURN is pressed. Once a 
full screen appears, the user is offered a choice; If the screen 
record is correct, simply view as long as needed and then type x 
and RETURN. This will return to the main menu. If the first 
screen seen is NOT correct (there may be several with the same 
key), press RETURN and the program will search for another 
screen record with the same key. 

Search records— This feature has two main purposes. One is to 
find screen records where the “key” field information is unknown. 
The second is to give the program operator a chance to view an 
entire SERIES of screen records which are LINKED by search 
boundaries the operator has chosen. Here’s another example from 
our ABC SALES program: 

L The operator wishes to find the invoice to “Abbott Jewelers” 
but does not know the Acct # to find “Abbott Jewelers” with 
the Look up command. The Search command is chosen instead. 

2. After ’s’ and RETURN are pressed, the operator sees the 
prompt: 



Since the operator doesn’t want to see “all” of the invoices to find 
“Abbott”, the ’s’ is pressed for ’selected’ records. 

3. Next the operator sees the prompt: 
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Here the operator types ’fist’ and sees a list of all 14 fields 
(except grand totals). The operator wants to search 
alphabetically so field Hi Customer Name, is selected for the 
search. 

4. The next prompt reads: 



Here ’Smallest’ means lowest in the alphabet. Notice that the 
prompt offers 30 dots to fill in? That’s because your CODEWRITER 
program “remembered” that field #1 was designed to have 30 
characters maximum. The operator types ’Ab’ which means that 
records with ’Customer Name’ beginning lower in the alphabet 
range than “Abbott” (say Aaron, for instance) would be omitted 
from the search. Remember a lower case letter is ’lower’ than its 
UPPERCASE counterpart (i.e. ’a’ is lower than ’A’). 

5. Tne next prompt: 



is answered; ’Abbott’ so that nothing above ’Abbott’ will be 
searched. The records within the range will be displayed one at a 
time along with the prompt: 
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and so the operator simply presses RETURN until the desired 
record is displayed and then types x to halt the search 


A few more items concerning ’Search’; 


1. On an alphabetic search of, say, A to D remember that a lower 
limit of A is fine but D alone as the upper limit will leave out 
everything beyond D by itself. To search a file A through D, 
enter aA and dDZz as the two limits. 


2. Remember that to a computer A is different from a. If you used 
capital letters in your fields, use capitals in your search limits. 


3. Where a search field is a date, you’ll be offered 
instead of dotted entries. You may search through a range of 
dat^. 


Delete record— This menu option removes records from the fiile 
disk. It works by asking the operator for the entry to the “key” 
field and then displays the screen record in question, by 
answering the “is this it” prompt with RETURN, the record is 
deleted. 


Verify grand totals— Because of occasional instances of computer 
“rounding off’ certain sums, the Verify’ option is included. Simply 
enter ’v’ and RETURN. No other entry is needed. All of the ’grand 
total’ fields on the screen will be checked for accurate mathematic 
sums. The Verify option appears ONLY when a file contains grand 
totals. 


Exit— This is simple, but can be easy to forget. After EACH 
session of data entry is complete, exit the program with THIS ’x’ 
RETURN option. Do NOT simply turn the computer off. The ’Exit’ 
routine in your program performs a number of very important 
“computer housekeeping” tasks which keep the data file reafy for 
reliable use. 


A FIHAL WORD 


We have tried in this manual to show the major features of 
CODEWRITER and how these features work interactively to allow 
the Program designer to control information. We’ve shown some 
thin^ in detail and only hinted at others—all ly design. 

^ CODEWRITER is a tool, to be discovered rather than explained. 


This CODEWRITER product is the first of a series aimed at mA.king 
PROGRAM DESIGN more powerful and capable a function. We hope 
never to lose sight of the fact that your gro'tvth is our growth. 


Appendix A --- The “Reject iff’ ruies 


We thought it would be helpful to have the two “reject if:” help 
screens for your CODEWRITER progi'am reproduced here for 
easier reference. 

screen one 


GENERAL TESTS 


Test name 

example 

meaning to operator 

no entry’ 


some entry required 

'not numeric’ 

- 

use only numbers here 

’numeric’ 

- 

don’t use numbers here 


DATA SIZE TESTS 

Test name 

example 

meaning to operator 

‘length >’ 

length) 4 

no more than 4 keystrokes allowed 

’length < ’ 

length < 7 

no less than 7 keystrokes allowed 

’length^’ 

length=2 

must NOT be 2 keystrokes 

’length ( ) • 

length 0 3 

must be 3 keystrokes 


screen two 


NUMBER TESTS 


Test name 

example 

meaning to operator 

•> 

’<■ 

>100 

must NOT be greater than 100 

<20 

must be 20 or higher 


=631 

must NOT equal 631 

•O’ 

017 must equal 17 

CHARACTER TESTS (note double quotes) 

Test name 

example 

meaning to operator 

•> • 

• (' 

>”d” 

must NOT be alter "d" in the dictionary 

("jo” 

must NOT precede "jo" in the dictionary 

’=’ 

="biir’ 

must NOT be “biH’’ 

’<> ■ 

< > "male" 

must be "male" 

’contains' 

contains ’’abc" 

must NOT contain 3-letter group "abc" 


The various symbols used in “reject if:” syntax may not be 
familiar. Here’s a detailed explanation. We’ll take the tests in 
order. 
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the backward or opposite nature of the prompt: the designer is 
asked to state what he does NOT want rather than what he does. 
Help is on the way. 

HO ENTSY—Since the purpose of “reject if:’’ tests is to let the 
program operator know what is NOT accepted entry, “no entry’’ 
as a test is vital. When the program designer answers a “reject 
if:’’ with “no entry” the meaning is: “Don’t skip over this field—it 
will be rejected if there is no entry.” 

Use the ’no entry’ test when the field in question is the KEY 
FIEID. Without the ’no entry’ test, the operator could leave the 
key field blank. With nothing in the k^ field, the ENTIRE SCREEN 
RECORD would be lost to the CODEWRITER system. 

Anytime you wish to DEMAND SOME ENTRY to a field, use this 
test. 

HOT HtIMBEIC—Again we must think in opposites. V/here a field 
is designed for number type information only (i.e. quantity, 
number of days, part number, etc.) the designer should “reject” a 
“not numeric” entry by the operator. 

This is critically important where a number will be part of a 
calculation. Obviously, if an operator answers a quantity question 
with “two” instead of “2”, the calculation function wRl not work. 

HHMBSR—Where a designer wishes ONLY TEXT to be entered to 
a field, the “reject if;” “number” is used CODEWRITER wlR not 
accept the keystrokes 0 through 9 under this test. 

LEHGTH > —The meaning here is “length greater than”. The “ > ” 
sign the computer S 3 nnbol for “greater than”. Literally, what is to 
the LEFT or LARGE side of the “ > ” is greater or larger. 

In the case of “length”, the “reject if:” meaning is the number of 
keystrokes (both spaces and characters) allowed for entry. Thus, 
where NO MORE THAN a 5 digit number is acceptable entry, use 
“length) 5” meaning “length greater than 5” as the correct test. 

LIHGTH < —No surprise here. The “ ( ” symbol means “less 
than”. Thus, where a particular part number MUST HAVE at 
LEAST 6 digits, for example, the test “length < 6” will prevent an 
operator fi'om entering a number whose length is too short. 

XilHGfH=—Again, this is fairly clear. The meaning is “length 
equals”. The test will screen out a SINGLE PARTICULAR LENGTH 
as “reject if: length=3”. This test is not used very often, but 
COMBINED with some other test, may be useful. 

LIHGTH () —The “ (> ” symbol is computerese for “does not 
equal”. Where a designer wishes ONLY A SPECIFIC LENGTH of 
entry and nothing more OR less, this test is used An entry of 6 
keystrokes and NOTHING EIEE would be tested with, “reject if: 
length (> 6” 
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QUANTITY and TEXT 


Where the four symbols,“ > ”, “ < and “ < > ” are used 
WITHOUT “length” and WITH numbers, they evaluate the 
QUANTITY INVOLVED rather than the number of keystrokes. 

> —This still means “greater than”. Where you wish to prevent 
an entry of ANY HIGHER QUANTITY than 100, for example, the 
test is “reject if; > 100”. 

< —As you’d expect, the “less than” symbol works to prevent 
ANY LOWER QUANTITY than the designer wishes from being 
entered To reject any lower entry than 50, for instance, the test 
is “reject if: < 50”. 

=—As before “equals” seeks out a SINGLE QUANTITY ONLY to 
reject. Where, as an example, the ONLY wrong amount is 200, the 
designer tests for this with “reject if: =200”. 

<) —The symbol means “does not equal” as before. Used 
without “length”, the test is to SEEK OUT A SINGLE CORRECT 
QUANTITY. Where the designer wants, say, only part 400 as a field 
entry, the test is “reject if: < > 400”. 

Be careful with “does not equal” as a test. Since it accepts ONLY 
ONE quantity as correct, it cannot be combined with other 
quantity tests. 

LITTIE TESTS 

When used with quotation marks and letters, the “ > ”, “ < ”, “=”, 
and “ < > ” test for POSITION IN THE ALPHABET OR DICTIOxNARY. 

> “ ”—In the example > “p”, the meaning is “greater than 

p” or “past p” in the alphabet. Using a SINGLE LETTER as we did 
limits the test to the FIRST LETTER in an entry. Thus the test 
’reject if: > “p” ’ would TRAP OUT all words beginning with r or 
any other FIRST letter LATER THAN p in the alphabet. 

Where MORE than one letter is used, dictionary position 
determines the “greater than” or “later than” test. The test 
’reject if: > “mac” ’ would eliminate ALL WORDS later in the 
dictionary than a word beginning with “mac”. 

( “ ’’—Here the meaning becomes “lower than” a FIRST 
letter or group of FIRST letters in the alphabet or dictionary. Tb 
trap out ALL “d” words or lower in the alphabet, the test is 
’reject if: (“e”’. Thus, only “e” words or higher could be entered 

=“ ”—As before “equals” looks for ONE THING only. Where, 

for some reason, the designer does not wish “frog’ as an answer, 
the correct test would be “reject if; =“fi‘og”. Several of these tests 
can be combined on a single field to trap out a LIST of words or 
letters not wanted 
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^ ^ Ab before, the “does not equal” symbol is used to 

trap out ONE SINGLE ITEM. Therefore if “tractor” is the only 
response the desi^er wishes to allow, it is demanded with “reject 
if: < > “tractor”. Also as before the “does not equal” test 
CANNOT be combined with others on the same field. It is seeking a 
single acceptable response. 

CONTAIHS “ ’’—The “contains” test is used ONLY with 
words and letters within the CODEWRITER system. If, for 
instance, a particular letter or group of letters is to be tested for, 
“contains” will do the job. 

Let 8 assume that a part number entry in some inventory 
analysis is “B1200” and'the designer wishes to allow NOTHING 
from the “C” series (Cl^OO, etc.) to get into the data by mistake. 
The correct test for the ’Part Number’ field would be ’reject if: 
contams“c”. All numbers and other letters would be ignored, but 
any entry containing “C” would be refused 
The “contains” test can also trap a CONTINUOUS GROUP of letters 
ANTWHERE in a word or sentence. Thus the test ‘reject if; 
contains “me” ’ wo’old trap out “me” as well as “men” BUT ALSO 
“some” and “stammer” (because they contain the 2-letter group 
“me”). ’Contains’ is a powerful test. Be careful. 

Keep in mind that with ail the letter and word tests, an UPPER 
CASE letter is not the same as its lower case counterpart. You 
may have to test for BOTH kinds of entry to really be sure you 
keep out what you want out. 

We hope this appendix makes the “reject if:” idea more clear. 
Remember, while your program designs will be made more 
powerful by using these tests, th^ are optional. Use them as you 
are comfortable mth them. 

TEB E1K)HT SYSTEM 

The creating of “reports” from data entry programs is the real 
payoff in program design. This is where machine controlled 
information is “humanized”. What was merely entered as it 
happened, is now looked over, compared, sorted, and rigorously 
manipulated until the program d^igner can answer the most 
useful questions: What does this mean? Are there patterns to 
what’s happened? Of all the information we’ve collected, what’s 
significant? 

In creating the instructions for The Report system for 
CODEWRITER, we’ve changed the rules a bit from the 
CODEWRITER data entry system. These new instructions will be 
shorter and wOl assume the following: 

1. That you are familiar with the workings of CODEWRITER-Disk 1. 
For the most part the answering of screen prompts and the 
syntax for entering calculations is the same. 

2. That you will generally understand the screen prompts and will 
be able to proceed. We will not include detailed examples with 
the screen prompt explanations, but will instead use the 
PROMPT SCREEN NUMBERS (usually in the upper right 
corner) to refer you ahead in the instructions for more “in 
depth” treatment—with examples. 

Why the change? The CODEWRITER Disk 1 data entry design 
system includes many functions for creating in fact “on screen” 
reports. By using the ability to calculate between fields and 





display grand totals as you go. CODEWRITER gives theUJam 
designer a lot of what’s needed for many kinds of reports. 

Thus, the Report System is intended to be an invitation to 
experiment with CODEWRITER to find report formats not possible 
with CODEWRITER alone. 

Don’t worry. We wouldn’t leave you alone. At the end of the 
screen prompt explanations, you’ll find the DESIGNER’S 
REFERENCE section of the Report System manual. 

DESIGNER’S REFERENCE is for the examples and fuller 
explanations needed to get the most out of your system. Where a 
screen explanation is expanded upon in DESIGNER’S REFERENCE, 
you’U be alerted. 

JUST WHAT IS A RBPORT? 

The answer is not as obvious as you might think. The broader 
your definition of “report”, the better reports you’ll design. Here 
are a few ideas; 

I Reports give the “status” of a file of information. How many 
items are below a certain number, how many above, etc. 

2. Reports seek out a pattern. If the designer imposes certain 
conditions, how man}^ of the entries in a file will quali^T? 

3. Reports pull together information to change its purpose. All the 
headings from an invoice file can be pulled together to form a 
mailing list. 

LIT’S BIUDI 

Before your first CodeWriter report, you’ll need to transfer two 
programs from your CodeWriter Report System disk (the disk with 
the data entry program you created). 

We’ll assume you are starting fresh with your Commodore CBM 64 
showing the message below and your disk drive is on. 

* ’ * * COMMODORE 64 BASIC Y2 * * ^ * 

64K RAM SYSTEM 38911 BASIC BYTES FREE 
READY 

Do the foUowing EXACTLY: 

1. Press the SHIFT and Commodore symbol keys at the same time to 
switch to UPPER/lower case mode. 

2. Place your CodeWriter Disk 2 (label facing up) into the drive. 

3. Type— load “sc5”,8 and press RETURN. 

4. Once loading is complete, remove the CodeWriter disk and insert 
your application disk in the drive. 

5. IVpe— save“(^;sc5”,8 and press RETURN. 

6. Once saving is complete, remove your application disk and place 
your CodeV/riter Disk 2 back in the drive. 

7. Type— load “sort”,8 and press RETURN. 

8. Once loading is complete, again switch disks, removing the 
CodeWrtier Disk 2 and replacing in the drive your application 
disk. 

9. Type— save “@>0:sort”,8 and press RETURN. 

The two needed programs (sc5 and sort) should now be on your 
application disk. You can veri^ this by checking the contents of 
your disk: 
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1. Type— load “$”,8 and press RETURN. 

2. Alter the ’ready’ re-appears. type— list and press RMTJRN. 

You should see a list (or directory) of the program files on your 
disk. The list should contain the “scS” and ‘‘sort” programs as 
well as a series of programs whose names begin with the screeen 
file name of your data entry program. 

Repeat the process, checking carefully, if ail is not as expected 
Watch the red ’activity’ light on your disk drive. If this light 
flickers on and off during the load or save process, something may 
be wrong with either the disk or drive. 

To load the Codewriter Report System, place the Codewriter 
disk (disk facing up) in the drive and type— load “report”,8 and 
press RETURN. 

You’ll see a brief copyright notice and the a reverse video 
WARNING SCREEN. The screen asks for confirmation that the 
two needed programs are in place on your application disk. Since 
they should be at this point, press the fl key to continue. 

You’ll need to SWAP DISKS again at this point. Remove the 
CodeWriter disk from the drive and replace it with your 
application disk. This disk contains the ’/s’ program and the ’/pcf 
program the Report System needs. 

CodeWriter Concept: There are two points we should consider 
before going further; One is the idea of a “record” as it’s used in 
the Report System. The second is using an 80 column screen on 
your 40 column Commodore CBM 64. 

1. A “report” is simply output from the data file of your choice. It 
may be a standard sheet of figures arranged in column form 
under headings you choose. It may also be a form letter using 
data from the file to fill in “holes” you designed or even a check 
or mailing label — they’re all reports of a sort. 

Thus, when you’re asked (later) ‘How many records across 
the page’ you’ll need, the meaning is; How wide is the screen 
segment needed to contain the information you want from ONE 
data entry record. We’ll explain more later. 

2. Your CodeWriter Report System allows you to create 80 column 
wide reports to either the screen or to your printer. How is 
this possible on a 40 column screen? When designing your 
report, certain sections of the Report System allow you to FLIP 
back and forth between TWO 40 column “screens”. You’ll 
normally see the left “half’ of your report design. To see the 
right “half’, press the key (a shifted dot on your keyboard). 

To return to the left segment, press the key (a shifted 
comma). 

Enter the name of the screen file EXACTLY as you entered it 
when designing your data entry S 3 mtem. 
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Enter ’a’ or ’e’ remembering that your date format must be the 
SAME as you used in data entry. 


You may use up to 28 characters for design credit. 


Your report program title may use up to 30 characters. 


This is the way the title page for your report will look. If you 
answer ’n’ for no here, the title page will be ERASED and you’ll be 
returned to SCREEN R5. 



Your computer screen should now instruct you to make the FIRST 
of two disk swaps. In each case there will be a pause after you 
press the key in question. Simply follow the instructions on the 
two SWAP screens. After the second swap, you’ll be ready to work 
n screen R8. 

The Report System will display all the PROGRAM CALCULATED 
fields defined in the original data entry program. You’ll see the 
“name” of the field along with its ’pc^’ and the calculation used 
(one ’pc’ at a time). For each 'pc’ you see displayed, enter the 
MAXIMUM LENGTH (4 to 9) that the field will need for this 
report. 

Here you are to declare NEW program calculated fields for use in 
this report. The next available ’pc’ # will be displayed You enter 
the calculations just as in the CODEWPJTER data entry program. 
However, you may not use the same ’pc’ # on BOTH sides of the = 
sign. 

{For more on NEW ’pc’ fields, 
see DESIGN NOTES—R9) 

Once the “definition” or calculation formula for each ’pc’ is 
entered, you’ll be asked if the entry is valid. The report system 
does some mathematical and syntax error checking of its own, but 
not enough to eliminate ALL kinds of mistakes. Caution here will 
pay ofil 

The ’brief description’ asked for here is to update the “list” of 
fields so you’ll be reminded that your NEW ’pc’ is available in your 
report—and for future ’pc’ calculations. 


The (d)ollar or (n)umber choice is for automatic formating. A’d’ 
choice makes your NEW 'pc’ display with two decimal places to the 
right. A choice of ’n’ is for normal numeric handling of the 
quantity. 
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about maximum len^h for these NEW ’pc’ fields. 

We’re getting close to the REAL POWER of the report System! As 
with any good report mechanism, the CODEWRITER Report System 
looks at ONE RECORD at a time. Keep in mind, however, three 
important choices you have: 

1. Not ALL records need to be included in a report. Some will be 
IRRELEVANT to your report goals. 

2. Not ALL PARTS (fields):of a record need to be included for 
evaluation. 

3. Only those records, or parts of records, you wish need to be 
DISPLAYED or PRINTED at ail. Your Report System design can 
LOOK at a record and EVALUATE its content without going to 
either screen or paper. Sometimes, Just a summary is enough. 

This Screen asks you to begin to VISUALIZE which parts of the 
data entry file are important in the report you’re designing now. 
While your ORIGINxAL data entry design may have used ALL of an 
40 column screen, this report may only concern a FEV/ of those 
fields. How large a SEGMENT of the screen or page will you need? 

Our ABC Sales Invoice example (from CODEWRITER 1) used most 
of the screen. But a CUSTOMER LIST could be extracted from 
those screens by using ONLY the ’name’, 'address’, and ’city’ fields 
and RE-ARRANGING them to fit 3-across on a screen segment OR 
directly on to mailmg labels. 

The question: “How many records do you wish displayed across 
the page?” asks you to CONSIDER the following; 

I Your screen workspace is 80 columns (with the left/right 
control) and your printed page space is naturally 80 columns. 

If the SIGNIFICANT INFORMATION from one record can be 
re-arranged to fit a space 30 columns wide, you’ll get TWO 
ACROSS on a screen (with space left over). You are, of course, 
free to use the ENTIRE screen width (simply ansvfer T). 

2. Remember, you’ll be allowed to MOVE AROUND the contents of 
your CODEWRITER data entry screen any way you wish— 
including adding NEV/ TEXT and NEW ’pc’ fields. 

The question: “How many lines long, etc” offers ALMOST the same 
choices. A full report page is 80 columns wide and 56 lines top to 
bottom. Since most screens displays only 23 lines at a time, you 
MAY want to consider that when declaring your record segment 
size. You may, of course, display as much of an 80 by 56 page as 
you wish to your screen. Your computer win SCROLL UP at your 
command, after displaying 23 lines, and show the rest. 

You’U always have the choice as to whether your report win be 
printed to paper or displayed on the screen. 
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first, but wni be much more clear after your first time tiH^. 

Just press on. Remember, mistakes are the way you know you’re 

learning! 

The last question asked on this screen is to verify your previous 
answers. A ’y’ or ’yes’ sends you onward in the Report System. 

An ’n’ or ’no’ ERASES both your entries and returns to “How 
many records across .. etc. There win be a short delay (5-8 
seconds) while a new program loads. 

This is where you design your report. As you see, a screen 
segment has been drawn by the Report System according to the 
dimensions you gave in SCREEN RIO. The vertical dashes mark the 
RIGHT HAND boundary of your report segment. The solid line is the 
top-to-bottom boundary. 

A*t the bottom of the screen is the familiar column and row 
position indicator from CODEWRITER I Here, however, your 
cursor movements are limited to the boundaries of the screen 
segment. 

The prompt line contains the following options: 


(E)nter— Allows a field to be positioned within the screen 

segment. Press ’e’ (without RETURN) and you’ll be 
asked whether your entry is (k)eyboard entered, 
(p)rogram calculated, or (t)ext. You’ll be asked if you 
want ’numeric formatting’ on any he’ fields marked 
with the ^ sign. Enter number of positions you need to 
the RIGHT of the decimal point. Text’ allows any 
keyboard character to be typed as usual. The ’list’ 
option works as always. Press the fl. key to stop 
entering. After an (E)ntry, the cursor returns to its 
LAST position. Move it to the NEXT place you wish to 
enter. 

(D)elete—Reverses the entry process. Any field, ke, pc, or text 
can be erased by moving the cursor over the FIRST 
character and pressing’d’. You’ll be asked if you’re 
sure. 

(M)ove— Allows any field already entered to be moved with the 
normal cursor keys. In this mode, the f3 key acts as 
tab to the far right. 

(H)elp— A full review of all screen entry procedures. 

e(X)it— Press ’x’ to stop the screen segment formatting 
prxess. 


(For additional information on this procedure, 
see DESIGNER’S REFERENCE R11) 
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Simply press RETURN after reading the screen. 


This is a look at the way your report record Thll appear when 
repeated across the screen as you designed. You’ll be asked if you 
would like to repeat the format display. This is in case your 
format was longer than ZZ lines and scrolled off the screen. Next 
Report System asks if you’d like to change anything about the 
screen you designed. Press ’y’ and the original screen segment will 
re-appear as you left it. 


Do you want report headings and page numbering? In many kinds 
of reports you will. But for projects like mailing lists, the report 
headings and page numbers would simply waste labels. 

The rule to keep in mind is: Where you want CONTINUOUS print 
with NO BREAKS at all, answer that you don’t want headings or 
page numbers. Caution: some printers do not support paging and 
with these CodeWriter will not give page numbers. The rest of the 
report page will be as usual. Consult your printer manual 


You’ll see a sample of the LEFT HALF of your report form (as in 
Screen R13). To view the RIGHT HALF, press (shifted dot). There 
are a total of three lines for headings. The top line or lines are 
normally used for a report heading, leaving a line for column 
headings if you wish. To SKIP the second line, enter a space and 
then press RETURN. Remember you may be working on HALF a 
page at a time, so you’ll need to be careful about centering. 


Here the report system introduce the subject of report sections. 
A section is simply a part of a report. Each part, or section, may 
be ENTIRELY SEPARATE from the others in design make-up, logic, 
etc. 

Where you enter a choice of MORE than ONE section, the Report 
System will automatically repeat the design process the 
appropriate number of times. 


There will be short delay (5-8 seconds) while a new program 
loads. 




This is where program design pays off. The Report Syst^^Hks 
the designer to decide which data records to EVALUATE W ^he 


report. Some reports MUST look at all records to gve the status 
check the designer wants. In other cases, only CERTAIN records 


should be included based on the information found in a 


PARTICULAR field within the record. Still other reports accept 
records for review only if some COMBINATION of conditions exist 


in several fields. Again, each section of a report can have entirely 
separate ’Accept if;’ criteria from all the others. Only ONE ’Accept 
if:’ evaluation is allowed per SECTION of your report. 


The design syntax for the ‘Accept if:’ statement is as in following 
example: 

Accept if: ke3 > 15 


which means; Accept the record in question for inclusion in the 
report IF the quantity held in field (k)eyboard (e)ntered 3 (ke3) 
is greater than 15. 


Study the example to be sure you can relate the syntax shown to 
the definition offered above. 


Should Ws Use All the records? 


Where you wish ALL the records to be part of your report, as in a 
complete summary, simply avoid all evaluations by entering ’all’ 
as im 

Accept if: all 

AND OR and NOT 


The words ’and;, ’or’, and ’not’ can help make the ’Accept if:’ 
statement a very sophisticated design tool. Here’s an example of 
the use of ’and’: 


Accept if: ke3=“male” and ke4 > 26 

Where keS is a field asking about sex and ke4 is a field for age to 
be entered, this ’Accept if:’ statement means: 

“In this report I am interested ONIY in those records in the file 
where the sex is male AND the age is over 25.” 

Again, look at the meaning and try to see how the ’Accept if:’ 
statement means the same thing. 

You might be intimidated by the ’Accept if:’ idea at first. Don’t 
worry. It’s simply a bit new. Use one or two in your early report 
designs and you’U soon be thinking up more and more uses. 


(For more about the ’Accept if:’ features of your Report 
System, DESIGNER’S REFERENCE R16a) 
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You will see the prompt “Do you want an overall summary?” only 
where you have asked for MORE than one section in your report. 
The meaning is: “Would you like a summary of ALL your 
summaries?”. 

In the next screen, you’ll be asked about the kind of summary 
information your report design will include. 

There wlQ be a short delay (5-8 seconds) while a new program 
loads. 


The Report System summary options are; Total, Average, Minimum 
(or minima), and Maximum (maxima). You’ll be offered the 
chance to SUM UP any DOLLAR and/ or IRJMBER fields which get 
INCLUDED in your report. 

The Summary Work Screen will show the fields you have created 
to date (with the usual ’list’ option). Below the field numbers 
you’ll see the 4 kinds of summary options ONE AT A TIME. Simply 
enter the field number (i.e. k^, pc3, etc.), and this field will be 
added to the KIND of s umm ary shown. 


For example, where keS is the quantity of some part, and you 
want your summary section to show the TOTAL of all those parts, 
enter “ke6” when the word ’Total’ is displayed for summary. Each 
field number you designate for ’Total’ing will be displayed across 
the ’Total’ line. 


When you’re finished with fields to ’Total’, press fl and the 
Summary Work Screen will continue on to ’Average’ in the same 
way. Again, where you want an average for a field entry, type in 
the field number and the designated field will be added to the line 
for inclusion in the summary section. 



The ’Itoimum’ option will display in your summary the 
SM A LL E ST of a particular quantity (i.e. What was the least 
amount of widgets ordered this month?). As you’d expect, 
’Maximum’ does the same thing; finding the greatest number 
among those evaluated by your report. 

Here you get a chance to design your summary section again. 
When you answer “y” to this option, your OLD summary is 
EPJ^ED and you RETURN to R18 to try again. 


The CODEWRITER Report System vriR assign a 3 digit number of 
your choice to each report you design. This makes identifying a 
report easier where several are used or report titles are long. 

"CodeWriter 


Once you’ve chosen the report number, you’ll make one final DISK 
SWAP to remove the CodeWriter Report System disk and replace it 
with your application disk. Your report program will be saved to 
this disk. 

The time needed to create and save your report will be much less 
than was used to create the data entry system. Report programs 
will average between 10 and 20 minutes creation time. Again, 
you’ll see the program lines scroll to the screen. The process is 
automatic, so you may leave the computer, but be sure the 
computer is not accidentally shut off while you’re away. 

THE SORT PROGRAM 

The CodeWriter “sort” program was placed on the application disk 
when we first began report design (see pages 4346). As the name 
implies, this program sorts the information in a data file so a 
report can be created most efficiently. For instance, where you 
want an alphabetic listing of names, the sort program could 
re-arrange the “name” fields in your data file automatically. 

Where you wish to print out certain golf scores, for example, from 
low score to high — sorting first by the “score” field makes it easy. 

CAUTION: Whether or not your report requires a sorting 
operation, you MJST RUN THE SORT PROGRAM each time you run 
a report. “Sort” updates certain iternal values in your data entry 
program which keeps things tidy, so please don’t forget. 

The procedure to run a report is the following: 

1. type— load “sort”,8 and press RETURN. 

2. type— run and press PiirURN. 

The sort program will ask for the number of report you wish to 
run and will then run the appropriate report automatically. You’ll 
be asked for the field number by which you want to sort. Of 
course, you needn’t sort at all. 

Not everything will be clear the first time you read it. Try a few 
report ideas Just to see what happens. Don’t worry about 
mistakes. The next few pages will explain certain report writing 
concepts more fully. Eqjoy controlling information. 
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SCREEN R9—The creation of NEW program calculated fields may 
be a bit unclear. Why are new calculations needed? Let’s look at 
an example; In the ABC Sales data entry program, the calculations 
used were to make the DATA ENTRY process easier for the 
operator—calculating price extensions, tax, totals, etc. The 
calculations were appropriate to the program. 

In a report program, the same information should be looked at in 
a different way. Now that we have the information IN the file, 
does it have a PATTERN? Does the data suggest a TREND? 

We’ll use the following data entry field examples to create NEW 
program calculations for a report; 

ke9 = paid with order pc2 = invoice total gtl = total receivables 
gt2 = total sales pc3 = invoice balance 

Where the program designer would like an analysis of how much 
each customer pays with his order in RELATION to the total order, 
a NEW ’pc’ called pc5 could be created for the report program: 

pc5 = (ke9/pc2)*100 

When asked for a “brief description’’ of the new pc (for the ’list’), 
the program designer could call pc5— “% paid with order”. 

In this case the answer to “maximum length” would be 3 as a 
percentage wouldn’t get above 100 (3 characters). 

Since it’s wise to be aware of how much customers OWE in 
relation to how much has been SOLD, a new pc6 for the report 
could be; 


pc6 = (pc3/gtl)*100 

and label the result “inv. bal. as % of rec.”—meaning ’invoice 
balance as a percentage of receivables’. 


ine most imponanL conbiaeraLion iii usuig latj nepori^^m is 
that it gives the designer ALL of the ENPORMATION of raWata 
entry system, while allowing the FORM of the information to 
change completely. 

Remember, when the Report System ’reads’ your data entry 
program, it will retain ONIY the field names and spaces you 
designed. It does NOT retain their positions on the data entry 
screen. There is no need for this. The Report System offers you 
the chance to pick and choose among the fields needed Their 
NEW positions within your report is entirely up to you. 

A “record”, within the Report System, is ANY field or group of 
fields from the data entry screen record RE-ARRANGED any way 
you wish. The screen segment created in work screen Rll is ONE 
of these new ’sub-records’ which you may REPEAT either across 
an 80 column screen or down a 56 line page. 

Let’s begin with a fairly direct example; You would like to create a 
mailing list ’report’ from the information in your invoicing 
program. You wish to ’strip off from the invoice form 
ONIY—Customer name, address, city, state (or district), and zip 
code (or other mail routing #). 

You begin the design on work screen RIO. The first question is 
’How many records across the page?’ As we are designing a 
mailing list, our screen segment (or record segment) is a single 
MAILING LABEL 

The work screen is 80 characters wide. If the ’name’ entry space 
in your data entry program is 25 characters or less, you could get 
3 mailing label ’records’ across (with tight margins). In our ABC 
Sales example, we used 30 characters of space for ‘Customer 
name’. This means that we can format 2 labels. Across the report 
screen. Thus, we answer ’2’ to the quesiton ’How many records 
across the screen?’ 

The next question on work screen RIO is ’How many lines long 
(1 to 56)?’ A standard design choice here would be “6”. Most 
mailing labels allow one blank line on top, 4 address lines, and one 
blank line below. 


At this point a short but useful report could be written. Print out 
only: 

Customer name . invoice # _ 

percent paid with order ... % Balance as % of receivables ... % 

Obviously, these examples are quite specific, but you should see 
that the new calculations possible in the Report System expand 
your design possibilities a great deal. 

SCREEN Rll—What is a screen segment? The creation of a screen 
segment allows the program designer to FOCUS the original data 
entry screen—so that the report can deal with SPECIFIC parts of 
collected information. 


Remember that on the data entry screen the SPACE to enter a 
customer name was always PRECEEDED by the words ’Customer 
name’. In the Report System the ’field label’ ’Customer name’ is 
NOT connected to the space (the 30 dot line). This is to provide 
the designer complete freedom to RE-LABEL the fields. 

Since we asked for a segment space of 40 spaces (80 divided by 
our “2” choice) wide and 6 lines down, work screen Rll begins ty 
DRAWING that area on the screen, lb begin label design, press ’e’ 
to Enter a field, and ’k’ to designate that the field is 'Keyboard 
entered’. You’ll be prompted by Report System to help you stay 
within the 40 ty 6 area Pr^s’m’ to Move your field around the 
area with the cursor control keys. Use the normal ’list’ option to 
remind you of the numbers of the fields which contain the data 
you want on your label. 
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Only the ’field type and #’ are connected to the field space by 
Report S}"st6m. Thus, the mailing label record segment would look 
like this on the report work screen: 

kel. 

ke2. 

ke3. ke4... 

This will work well as a mailing label. There is no need for 
anything but the address data itself, so the lack of field labels is a 
help. 

Let’s add a little advertising for ABC Sales on each label. Press ’e’ 
to Enter screen information and the’t’ to designate the 
information as ’text’. Move the screen cursor to just below the 
’ke3’ entry and type; “ABC MEANS QUALITY”. The label becomes: 

kel. 

ke2. 

ke3. ke4... 

ABC MEANS QUALITY 

Though it didn’t matter here, when you enter a number field on to 
Rll work screen, you’ll be asked if you want ’numeric formatting*. 
If you answer “y”, you’ll be asked ’How many digits to the right of 
the decimal point?’. This allows you to specify the display format 
of all numbers in the report. Where you want a number handled 
as an integer (whole number only), answer ’0’ for the digits to 
the right of the decimal point. 

JUST THS BIGIHHING 

The mailing label format is merely a simple way to introduce a few 
of the possibilities of Report ^stem. You needn’t work in “screen 
segments’’ at ail. By answering “1“ in screen RIO (for 1 record 
across) and 56 for the lines down, you have the space of more 
than two full Commodore screens to design your report layout. 

The more traditional ’columnar’ type reports can be built by using 
data entry fields and new program calculated ’report’ fields 
ACROSS the 80 column page: 

ke5.Ke6.pc7.pc8.kell. 

Later, on vrork screen R15, you can add a report title and column 
headings: 

The 198S Grape Harvest 

Grove location manager cost p/vine vat cost grape variety 

ke5.Ke6. pc7. pc8. kell. 
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When run, the column format will simply fill-in down tl^Been 
until the page size you chose (in lines) is full. Then a n^^age 
with the same headings will begin. If your report goes to the 
computer SCREEN instead of paper, the output display will stop 
when the 25 line screen is full and continue when RETURN is 
pressed 

TIXT IS A DESIGN ELEMENT 

The text feature we used for the mailing label advertising line can 
add lots of eye appeal and excitement to a report. Keep in mind 
that the CODEWRITER Report System lets you MIX text and data 
freely. Use the freedom. There’s no reason a report on operations 
can’t look like a breezy memo; 

The V/onder Wheel Company—Year 1982 

“Our greatest hopes for Wonder Wheel have come true. While the 
rest of the wheel industry was down pc5%, Wonder showed an 
encouraging pc8% increase—with a pc9% boost in market share. 


Td: ke3. in department ke6... 

We could not have come this far without your help. Your 

department’s pc3.S contribution to sales represents 

pcl2% of the total.’’ 


A ’report’ can be a form letter, a check, a purchase order or 
nearly anything which can be put to paper or screen. The report 
is simply a way of organizing input information to do a Job. Use 
the design screens to create! 

SCREEN RIBA-CREATING THE ’ACCEPT IF’ STATEMENT The best 
report programs look at the fewest data record screens while 
doing their work. This makes for fast, efficient reports which are 
easiest to design and easiest to use. 

The CODEWRITER Report sjmtem allows the designer to “describe” 
just the file information needed by using the ’Accept if:’ statement. 
In this reference section, we’ll deal with ’Accept if:’ as the 
descriptive language it is. Fith a very few components, the ’Accept 
if:’ statement can be used to gve amazingly complex instructions 
to your report programs. 

Here’s a list of the components and how they can help: 

The string constant—“string” is computer jargon for a 
“connected group of letters or characters”. The letters or 
characters may form a word or words, but the real distinction 
between strings and numbers is that numbers are grouped 
together to describe a quantity—and strings aren’t. The computer 
can’t calculate two strings. In an ’Accept if:’ statement, the String 
Constant is for DESCRIBING SPECIFTC LETTERS OR CHARACTERS 
to search for. Here’s an example: 

























ion wish U) gei some imormation on the people in the ciata hie 
named “Smith”. The ’last name’ field is ’kel’. Since you don’t want 
your report program to look at any screen records not assxiated 
with “Smith”, you write; 

Accept if; kel= “Smith” 

Only the “Smith” records will be inspected. Putting the word 
Smith in quotes makes it a string. It’s called a String constant 
because that particular ’Accept if statement ttIU check ONIY for 
“Smith”. We’ll look later at ways to make string checking 
variable. 


war simple one-name sear*cn, using a va' woula read; 

Accept if; kel=val 


The ’1’ in val simply means it’s the FIRST ’va’ we’ve used (any 
number could have been assigned). When the CODEWRITER Report 
System reads the ’Accept if;’ statement, the ’va’ will be detected 


The Report System will ’see’ that the designer wants records 
studied ONIY when the contents of ’kel’ (a name field) are the 
same as ’val’. It also detects that there is currently NO MEANING 
attached to ’val’. What is ’kel’ supposed to be equal to? 


The Date Constant—To check for a specific date on the same 
’constant’ basis as the strings above, simply put the date within 
signs—as in @12/10/82(®. Thus, if your report design was to 
look only at file information for records dated 6/12/82, and your 
date field is ke6, it is expressed as; 

Accept if; ke6= @6/12/82<® 

The idea to seek information only AFTER 6/12/82 looks like this; 

Accept if; ke6 > @>6/12/82<® (’>’ means ’greater than’) 

As with strings, dates need not always be constant in an 
expression. V/e’il show how this is done later. 

A NUMBER can easily be used as a constant in an ’Accept if;’ 
statement with no special syntax needed Where a report d^ign is 
to focus on quantities less than 50, for example, simply write; 

Accept if; ke5 50 (ke5 being a ’quantity’ here) 

As before, a number can be variable as well as constant. 

smcs LIFS IS VAEIABLF, SO AH HPOETS 

All the constants we’ve described can be very useful in report 
design. Very often, however, the IDEA of a report will remain the 
same, but the information needed must CHANGE each time the 
report is run. 

For instance, when we wrote the ’Accept if;’ line to find all the 
people named “Smith” in a file, the String Constant was fine. But 
such a report would seek out ONIZ “Smith” ALL THE TIME. It’s 
more helpful if we could write a report program which could 
isolate one name, as before, but allow the user to CHANGE the 
name being sought each time the report is run. 

For this, the symbol ’va’ is used—meaning ’Variable 
Alphanumeric’ or String Variable. Using the ’va’ is simple. It’s a 
two-step process; First, assign some MEANING to a ’va’ (adding a 
number to remember which ’va’ is which) and, secondly, writing a 
QUESTION for the user of the report—asking for a response 
which fits the meaning. Here’s how; 
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Whenever a VARIABLE (like ’va’) is detected in an ’Accept if;’, the 
CODEWRITER Report System will ask the designer to 'write a user 
prompt’—that is write a question or request asking for the 
MEANING of the variable to be inserted when the report is run. 

The user prompt for our one name search could be; 

“For what name should this report search?” 

The user would then enter a name (1^ typing it in), and report 
would carry out its search duties. 

Where the variable is a NUMBER, the procedures are the same 
except that the designation ’vn’ (variable number) is used 
instead. 

Using DATES as report variables is also the same—with one 
exception. The designation is ’vd’ (variable date), but ’vdl’ is 
ALWAYS THE SAME. The CODEWRITER Report System will ask at 
the beginning of every report ‘'What is tody’s date?”—that is 
the date the report is being run. This date is labeled ’vdl’ by 
CODEWRITER and reserved. When designing ’Accept if;’ statements 
involving variable dates, begin with ’vd2’ or greater. 

Naturally, you may use the ’vdl’ in YOUR statements whenever 
you’d like the date the report is run to be part of a condition—as 
in; 

Accept if; ke4 < vdl 

This comes in handy in a bill payment report, for instance. Where 
’ke4’ is the due date for a bill on file, the ’Accept if;’ shown above 
means; Let’ look at ONIY the bills where the due date is EARLIER 
than (less than) TODAY’S date. (i.e. which bills are overdue?) 

AND, OR, ^ NOT (AS IF WE DIDN’T HAVE ENOUGH POWER) 

You have now seen all the components of the ’Accept if;’ 
statement. From now on the increases in capability come from 
COMBINING, EQUATING, or NEGATING them to form new ideas. 

The words ’and’, ’or’ and ’not’ are used here as in normal thought. 

Let’s go right to some examples; 
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